Composer 不会自动清理 VCS 缓存，因该缓存不受 cache-files-ttl 等参数控制，且无内置自动 GC 机制；需手动或脚本按需清理，或通过 prefer-dist、--no-cache 等配置绕行。
composer clear-cache 不会自动清理过期的 VCS 缓存，Composer 本身也没有内置配置项能“自动定期”删掉 ~/.composer/cache/vcs/ 下闲置的 Git 克隆。所谓“自动清理”，必须靠手动干预或脚本兜底。
为什么 cache/vcs/ 会长期堆积且不自动清理
VCS 缓存（~/.composer/cache/vcs/）是 Composer 对 Git、HG 等仓库做的裸克隆（bare clone），用于加速 composer install 时的源码拉取。它不按 TTL 过期，也不受 cache-files-ttl 或 cache-files-maxsize 控制——这些参数只管 files/ 和 repo/。只要某个包还在任意项目的 composer.lock 中被引用过，它的 VCS 缓存就可能一直留着，哪怕你半年没碰那个项目。
- Git 仓库缓存不会因远程分支更新而自动 fetch —— Composer 默认只 shallow-clone 一次，后续全靠本地快照
- 没有 “vcs-cache-ttl” 或 “prune-vcs” 配置项，官方明确不支持自动 GC
-
composer clear-cache会清vcs/，但它是全量操作，无法区分“还在用”和“已废弃”
如何安全地手动清理不用的 VCS 缓存
最稳妥的做法不是等它“自动”，而是按需删：先确认哪些 VCS 缓存真没人用了，再删对应目录。不要直接 rm -rf ~/.composer/cache/vcs/*（虽然常见，但风险高）。
- 查当前所有项目依赖的 Git 源：运行
composer show --all | grep source，筛选出source: git的包，记下其 URL（如https://github.com/symfony/console.git） - 把 URL 转成缓存路径：去掉
.git后缀，将https://替换为https---，所有/替换为-，例如https://github.com/symfony/console.git→https---github.com-symfony-console - 进
~/.composer/cache/vcs/目录，保留上述转换后的子目录，其余全删（Linux/macOS 可用find . -mindepth 1 -maxdepth 1 -type d ! -name 'https---github.com-symfony-console' -exec rm -rf {} +） - Windows 用户可用 PowerShell：
Get-ChildItem "$env:APPDATA\Composer\Cache\vcs" -Directory | Where-Object Name -NotMatch "https---github.com-symfony-console" | Remove-Item -Recurse -Force
在 CI/CD 或部署脚本中自动清理 VCS 缓存的可靠写法
CI/CD 场景下，你通常不需要保留任何 VCS 缓存（每次构建都是干净环境），这时可以放心全清，但要注意时机和权限。
- 务必在
composer install或composer update之前执行，否则可能触发Corrupted cache file报错 - 避免用
composer clear-cache，它不保证清掉vcs/（某些旧版 Composer 会跳过）；直接删目录更可控 - Linux/macOS 推荐命令：
rm -rf $(composer config --global cache-dir)/vcs/* - PowerShell（Windows）必须加
.Trim()：Remove-Item -Recurse -Force "$((composer config --global cache-dir).Trim())\vcs\*" - 如果构建用户不是 root，确保该用户对
vcs/目录有写权限（常见坑：之前用sudo composer install写入，现在普通用户删不掉）
想让 VCS 缓存“自动失效”？只能靠配置绕行
没有真正意义上的自动清理，但你可以让 Composer 少用甚至不用 VCS 缓存：
- 强制走 dist 包：在
composer.json中加"prefer-dist": true，并确保私有源提供dist字段（ZIP 下载地址），这样 Composer 就跳过 Git clone 步骤 - 禁用 VCS 回退：设
"no-plugins": true并配好镜像源，可减少对原始 Git 仓库的依赖 - CI 环境统一加
--no-cache：如composer install --no-cache --prefer-dist，完全跳过缓存逻辑，包括vcs/ - 注意：禁用 VCS 会增加首次安装耗时和带宽消耗，别在本地开发频繁用
真正难处理的不是“怎么删”，而是“删完之后谁来重建”。VCS 缓存重建需要完整 Git 克隆，如果网络受限或私有 Git 服务不可达，composer update 会卡住或失败。所以清理前，先确认你的 Git 源可达、凭证有效、SSH key 已加载——这些细节比删目录重要得多。
