必须同步清理缓存、VCS元数据快照、installed.json和composer.lock四者,否则Composer仍按旧锁和旧元数据决策;仅clear-cache无效,因真实检出状态藏于这三处,且锁文件具有最高优先级。

为什么composer clear-cache对VCS更新没用
这个命令只清理~/.composer/cache/files/(ZIP包)和~/.composer/cache/vcs/(Git克隆的浅拷贝),但VCS依赖(如"monolog/monolog": "dev-main")的真实元数据和检出状态,藏在三个更关键的位置:远程仓库索引快照、本地已安装记录、锁文件。不碰这三处,Composer永远按“旧快照+旧锁”做决策,根本不会重新拉取最新commit。
必须同步清理的三个位置(顺序不能错)
VCS依赖更新失败,90%是因为只清了缓存却漏掉下面任一环节:
- 先运行
composer clear-cache——避免旧ZIP或浅克隆干扰后续操作 - 删VCS元数据快照:
rm -rf $(composer config --global cache-dir)/vcs/(Linux/macOS);Windows PowerShell中用Remove-Item -Recurse -Force "$env:APPDATA\Composer\Cache\vcs\" - 删
vendor/composer/installed.json——它硬编码了当前VCS包的source.reference(即commit hash),不清它,composer show和依赖解析仍认为“已是最新” - 删
composer.lock——这是最顽固的一环:只要它存在且含该VCS包条目,composer update就绝不会改其source.reference,哪怕远程分支已推进10个commit
验证是否真刷新了VCS元数据
别信命令返回“Cache cleared”,要亲眼看到Composer重新走网络:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 运行
composer update --dry-run -v - 紧盯输出里有没有
Cloning或to Downloading https://api.github.com/repos/xxx/xxx/commits/main - 如果只看到
Reading /path/to/cache/vcs/xxx.git/,说明vcs/目录没删干净,重来 - 额外注意:若VCS包在
composer.json中用了"dev-main#abc123"这种带commit hash的写法,Composer会跳过更新——这不是缓存问题,是显式锁定
composer.lock是VCS更新的终极开关
很多人删完vcs/和installed.json,却留着composer.lock,结果update依然不动如山。因为Composer把锁文件当“事实权威”:只要锁里写着"source": {"reference": "old-hash"},它就认定“这个版本就是你要的”,连远程都不查。这个行为比缓存还刚性——缓存清了还能自动重建,锁文件不删,它就永远不触发VCS刷新逻辑。










