Composer不支持VCS别名,生效的仅有type="vcs"、合法url及可选options;缓存复用取决于url哈希值是否一致,URL微小差异(如协议或斜杠)即导致新缓存生成。

Composer 不支持为 VCS 仓库配置“别名”(如 my-vcs)来替代真实 URL,所谓“VCS 别名”是常见误解;真正起作用的是 repositories 中的 url 字段和 require 中的包名+版本约束。旧缓存是否保留,取决于你是否清除了 vcs 子目录,而非别名设置。
为什么“VCS 别名”根本不存在
Composer 的 repositories 配置中没有 alias、name 或 id 字段。你写的任何非标准键(比如 "alias": "my-git")都会被完全忽略。生效的只有:type(必须是 vcs)、url(必须能 git clone),以及可选的 options(如 ssh 认证参数)。所谓“用别名引用私有包”,其实是误把包名(如 acme/utils)当成了别名——它实际来自 Git 仓库根目录下的 composer.json 中的 name 字段。
如何让新 VCS 配置不丢旧缓存
VCS 缓存存在 {$cache-dir}/vcs/ 下,路径由仓库 URL 的哈希值决定。只要新配置的 url 和旧的一致,Composer 就会复用原有缓存;URL 只要有一个字符不同(比如 https vs git@,或末尾多一个 /),就会生成全新哈希路径,旧缓存即失效。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 检查当前缓存是否在用:
composer diag查看Cache directory,再ls -l $(composer config --global cache-dir)/vcs/观察子目录数量和修改时间 - 确保新
repositories条目中的url与之前完全一致(包括协议、大小写、结尾斜杠) - 不要执行
composer clear-cache—— 它会连带清掉vcs/目录;如只需清理元数据,只删repo/子目录即可 - 若已改过 URL 又想救回旧缓存,可手动复制旧哈希目录到新哈希路径下(先用
git ls-remote $OLD_URL验证两者内容一致)
修改 VCS 配置后依赖没更新?先查这三处
常见现象:改了 repositories.url,composer update 却仍拉旧 commit 或报 Could not find package。这不是缓存问题,而是 Composer 没触发重新探测。
-
composer.lock锁定了旧的source提交哈希,必须运行composer update vendor/package --with-dependencies强制刷新该包来源 - 如果包名在
require中写的是dev-main,而新仓库主分支叫main-v2,就得同步改成dev-main-v2 - GitLab/GitHub 私有仓库若启用了 2FA 或 token 权限变更,
git clone $URL手动测试会直接暴露认证失败,此时 Composer 会静默 fallback 到其他源或报错
最易被忽略的是:VCS 缓存复用只看 URL 哈希,不看仓库内容是否变更;哪怕你 git push --force 覆盖了历史,只要 URL 没变,Composer 就可能继续用本地 vcs/ 缓存里的旧 ref 数据,导致 composer update 看不到新 tag —— 这时得手动删掉对应哈希目录,或加 --prefer-source 强制重拉。

















