必须同步删除三处:~/.composer/cache/vcs/(VCS裸仓库)、composer.lock(锁定的commit哈希)、vendor/composer/installed.json(本地安装快照);否则Composer仍复用旧reference,不拉取最新commit。

直接删 vcs/ 目录最有效,但必须配合删 composer.lock 和 vendor/composer/installed.json,否则 Composer 仍会复用旧提交哈希。
为什么 composer update 不拉 VCS 最新 commit?
VCS 依赖(如 "monolog/monolog": "dev-main" 或 Git URL)的更新不同步,根本原因不是 ZIP 缓存,而是 Composer 在 ~/.composer/cache/vcs/ 下保留了裸仓库(bare repo),并基于它做 diff 和 checkout。它不会主动 git fetch --all,除非你强制刷新或删掉这个缓存目录。
常见现象包括:
-
composer update输出 “Nothing to install or update”,但git log明明有新 commit - 执行
composer install后vendor/里仍是旧代码,composer show monolog/monolog却显示最新 commit hash -
--no-cache对 VCS 无效——它只跳过files/,不碰vcs/
必须同步清理的三个位置(VCS 场景)
只删 vcs/ 不够,因为 Composer 会从 composer.lock 中读取已记录的 source.reference,再从本地 vcs/ 里 checkout —— 如果两者都旧,就彻底锁死。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 删 VCS 缓存:运行
rm -rf $(composer config --global cache-dir)/vcs/(Linux/macOS);Windows PowerShell 用Remove-Item -Recurse -Force "$env:APPDATA\Composer\Cache\vcs\" - 删锁文件:运行
rm -f composer.lock(项目级)或rm -f ~/.composer/composer.lock(全局插件场景) - 删安装快照:运行
rm -f vendor/composer/installed.json(确保composer show和依赖解析重新生成状态)
composer update 后仍 checkout 旧 commit 怎么办?
这说明 composer.lock 没清干净,或者你用了 --prefer-dist(它会绕过 VCS,优先走 ZIP)。验证方式:
- 检查
composer.lock中该包的"source": {"type": "git", "reference": "abc123..."}是否是期望的新哈希 - 运行
composer update --dry-run -v,看输出中是否出现Cloning abc123... from ...,而不是Using version dev-main for ... - 若仍不对,加
--prefer-source强制走 Git 克隆流程,避免 dist 缓存干扰
私有 Git 仓库更新后怎么精准清理?
私有 VCS(如 GitLab、GitHub Enterprise、自建 Gitea)的缓存路径和公开源一样,但需确认 URL 格式是否被正确转义。例如:
- 仓库地址为
https://gitlab.example.com/group/project.git→ 缓存路径是~/.composer/cache/vcs/https---gitlab.example.com-group-project.git/ - 可直接删整个
vcs/,也可只删对应子目录(更安全,不影响其他仓库) - 删完后首次
composer update会触发完整git clone --mirror,耗时略长,但之后的update就会git fetch增量更新
最容易被忽略的是 composer.lock 里的 source.reference —— 它不是缓存,但行为比缓存还顽固:只要它存在且没变,Composer 就不会尝试拉新 commit,哪怕 vcs/ 已空、installed.json 已删。










