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 文件生成逻辑,但它的误命中会导致看似无理由的依赖解析变慢或跳过预期更新——这点最容易被忽略。










