Composer 的 solver cache 默认存放在 Composer 缓存根目录下的 solver/ 子目录中，路径由 COMPOSER_CACHE_DIR > COMPOSER_HOME > 系统默认决定，Linux/macOS 为 ~/.composer/cache/solver，Windows 为 %APPDATA%\Composer\cache\solver。

Composer 的 solver cache 默认存放在哪里

Composer 的依赖解析缓存（即 solver cache，用于加速 composer install 和 composer update 中的依赖图计算）默认不与全局 cache（如 vendor/ 或下载包缓存）混用，而是独立存放于 Composer 自己的缓存目录下，具体路径取决于操作系统和 Composer 版本（v2.0+ 统一使用 XDG Base Directory 规范）。

• Linux/macOS：$COMPOSER_HOME/cache/solver（$COMPOSER_HOME 通常为 ~/.composer）
• Windows：%APPDATA%\Composer\cache\solver
• 若设置了 COMPOSER_CACHE_DIR 环境变量，则全部缓存（含 solver cache）会移至该路径下的 solver 子目录

如何确认当前 solver cache 实际路径

最可靠的方式是让 Composer 自己输出——它不提供单独查 solver 路径的命令，但可通过 debug 模式观察缓存读写行为，或直接查其缓存根目录：

composer config --global cache-dir

执行后得到的路径就是缓存根目录，solver cache 就在该路径下的 solver/ 子目录中。例如输出 /home/user/.cache/composer，那 solver cache 就在 /home/user/.cache/composer/solver。

• 注意：该路径可能被 COMPOSER_HOME 或 COMPOSER_CACHE_DIR 覆盖，优先级为 COMPOSER_CACHE_DIR > COMPOSER_HOME > 系统默认
• composer diagnose 不显示 solver 路径，仅检查 cache 是否可写

solver cache 的文件结构和触发条件

solver cache 不是单个文件，而是一组按 hash 命名的 JSON 文件，每个对应一次特定的 composer.json + lock 状态 + platform config 组合。只有满足以下条件时 Composer 才会读取或写入它：

• 运行的是 composer install（非 --no-suggest / --ignore-platform-reqs 等干扰参数）且存在 composer.lock
• 运行 composer update 时未加 --with-all-dependencies 或 --dry-run 等跳过 solver 的选项
• 当前平台配置（PHP 版本、扩展启用状态等）与缓存生成时一致，否则缓存被忽略

典型文件名类似：5a3f8b2d4e7c1a9f0b2e5d8c7a6f9b0e.json，内容为解析后的依赖树快照。

手动清理 solver cache 的安全方式

不需要删整个 cache 目录。solver cache 独立存在，可精准清理：

rm -rf $(composer config --global cache-dir)/solver

Windows 用户可用 PowerShell：

Remove-Item -Recurse -Force "$env:APPDATA\Composer\cache\solver"

• 不建议用 composer clear-cache：它只清下载包缓存（repo/、files/），**不清理 solver/ 目录**（这是长期被文档遗漏的行为）
• 修改了 php.ini 或切换了 PHP 版本后，旧 solver cache 会失效，但 Composer 不自动清理，可能造成“明明改了 ext-curl 却仍报冲突”的假象

solver cache 是透明加速层，不参与 lock 文件生成逻辑，但它的误命中会导致看似无理由的依赖解析变慢或跳过预期更新——这点最容易被忽略。