composer clear-cache 不会删 VCS 缓存,因其默认仅清理 files/、repo/ 和 archives/ 目录;vcs/ 存 Git 裸仓库,用于加速开发版安装,需手动按 URL 哈希定位并删除对应子目录,否则可能导致重装仍用旧 commit。

为什么 composer clear-cache 不会删掉 VCS 缓存?
composer clear-cache 默认只清 files/(下载的 zip)、repo/(元数据)和 archives/,但 vcs/ 目录是独立存在的——它存的是 Git 克隆的裸仓库(.git),用于加速 dev-master 或 dev-feature/xxx 这类开发版安装。VCS 缓存不参与校验哈希、不被 --no-cache 跳过,一旦损坏或滞后,就会导致「重装仍是旧 commit」或「Failed to download」。
怎么定位并删除某个包的 VCS 缓存目录?
Composer 的 vcs/ 缓存路径结构固定:~/.composer/cache/vcs/{url-hash}/,其中 {url-hash} 是 Git 仓库 URL 的 SHA256 值(不是包名)。所以不能靠包名直接删,得反查:
- 先运行
composer show -s vendor/package,看输出里source字段的 URL(比如https://github.com/vendor/package.git) - 再用命令算 hash:Linux/macOS 上执行
echo -n "https://github.com/vendor/package.git" | sha256sum | cut -d' ' -f1;Windows PowerShell 用[System.Security.Cryptography.SHA256]::Create().ComputeHash([Text.Encoding]::UTF8.GetBytes("https://github.com/vendor/package.git")) | ForEach-Object {$_.ToString("x2")} | Join-String - 进入缓存目录:
ls ~/.composer/cache/vcs/,找匹配该 hash 的子目录 - 确认无误后删:
rm -rf ~/.composer/cache/vcs/{hash}
VCS 缓存删错或删漏会怎样?
删错一个无关的 vcs/ 目录,顶多下次拉取对应仓库时多花几秒重建裸库,完全安全;但删漏了,问题就明显:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 你改了 GitHub 仓库的
dev-main分支代码,composer update vendor/package却仍装旧 commit —— 很可能vcs/里还存着老克隆,Composer 优先从本地裸库检出 - 报错
Failed to clone https://...: could not read from remote repository,但网络正常 —— 往往是缓存里裸库的origin地址失效或权限变更,需手动清理 - 某些私有 GitLab 仓库启用了 token 认证,token 更新后,旧
vcs/目录里的origin还记着过期凭据,必须删掉才能触发重新认证
删完 VCS 缓存后要不要补其他操作?
要,单删 vcs/ 不够:
- 必须同步删掉项目级的
vendor/vendor/package/(否则 Composer 可能跳过重装) - 如果该包在
composer.lock中锁的是"reference": "abc123",而你已推送新 commit 到同一分支,得先composer update vendor/package --with-dependencies强制刷新 reference - 全局安装的插件(如
phpstan/extension-installer)还要额外确认~/.composer/composer.lock和~/.composer/vendor/是否同步清理,否则global update仍走旧状态
VCS 缓存是唯一一种「删了立刻重建、且重建成本可控」的缓存类型,但它也是最常被忽略的那一个——因为错误不报红,只悄悄给你旧代码。

















