Composer拉取VCS旧提交是因复用本地vcs/缓存裸仓库且不自动检查远程新commit;需手动删除~/.composer/cache/vcs/对应哈希目录,并配合--no-cache --prefer-source强制重新clone。

Composer为什么总拉VCS旧提交,不是网络问题
你执行composer update vendor/package,明明远程 Git 分支(比如 dev-main)已推送新提交,但 vendor 里代码还是旧的——这不是 Composer 没联网,也不是 Git 仓库不可达,而是它复用了本地 vcs/ 缓存里的裸仓库,并基于旧 HEAD 解压。Composer 默认不检查远程是否有新 commit,只要本地 vcs 缓存存在、且分支 ref(如 refs/heads/main)没变,它就直接 checkout 旧快照。
删 vcs/ 子目录才是关键,别只清 files/
composer clear-cache 对 VCS 缓存完全无效:它只清 files/(ZIP 包)和部分 vcs/ 克隆,但不会碰已存在的裸仓库目录。真正要动的是 ~/.composer/cache/vcs/ 下对应 Git URL 的哈希子目录:
- 先定位缓存路径:
composer config --global cache-dir→ 进入vcs/子目录 - 找匹配包的目录名:通常含 Git 域名 + 路径哈希,例如
github.com-2913760544或gitlab.example.com-8a3b2c1d - 确认该目录下
config文件里url =是否指向你正在用的仓库(避免误删其他项目缓存) - 删整个目录:
rm -rf ~/.composer/cache/vcs/github.com-2913760544(Linux/macOS)或 PowerShell 中Remove-Item "$env:APPDATA\Composer\Cache\Vcs\github.com-2913760544" -Recurse -Force
强制同步最新分支的两种可靠方式
删完 vcs 缓存后,还需明确告诉 Composer “必须重 fetch”,否则它可能跳过远程更新:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 加
--no-cache:跳过所有本地缓存(包括 vcs 和 files),强制走完整 Git clone + checkout 流程 - 加
--prefer-source:确保用 Git 源而非 dist ZIP,同时触发 fresh clone(即使 vcs 目录刚被删,也能立刻重建) - 组合使用最稳:
composer update vendor/package --no-cache --prefer-source -v;输出中看到Cloning [commit-hash] from [url]才算真正同步成功 - 注意:如果分支是
dev-feature/x,而远程已删该分支,Composer 会报Could not find branch dev-feature/x—— 此时需先改composer.json里的版本约束,再重试
私有 Git 仓库权限变更后容易漏掉的点
换 SSH key、升级 GitLab 2FA、或从 HTTPS 切到 OAuth token 后,光删缓存不够:
- VCS 缓存目录里可能残留旧认证凭据(如
.git/config记了旧 token),导致新 clone 失败但报错模糊(如Permission denied (publickey)) - 务必删完 vcs 目录后,手动验证能否用相同凭据
git clone成功(尤其 CI 环境里 SSH agent 可能未加载) - 若用 GitHub/GitLab Personal Access Token,URL 必须带 token:
https://<token>@github.com/user/repo.git</token>,且 token 权限需包含repo(私有库)或public_repo(公开库)
真正麻烦的从来不是“怎么装新代码”,而是“怎么让 Composer 彻底忘记它曾经见过的那个旧 commit”。vcs 缓存不清理干净,--no-cache 都救不了。

















