Windows下VCS缓存实际位置是%APPDATA%\Composer\Cache\vcs\,内含以github.com-username-repo.git命名的Git裸仓库;损坏时需删除对应子目录而非局部文件,composer clear-cache或手动清理均可修复。

Windows下VCS缓存实际存在位置在哪
Composer在Windows中把Git等VCS仓库的裸克隆副本存在%APPDATA%\Composer\Cache\vcs\,不是%APPDATA%\Composer\Cache\files\或repo\。这个目录下每个子目录名形如github.com-username-repo.git/,内部是标准Git裸仓库(含objects/、refs/等)。它和ZIP包缓存完全隔离,composer clear-cache会清掉它,但手动删更可控。
VCS缓存损坏导致“update卡在Cloning”怎么办
常见现象是composer update卡在Cloning into 'C:\Users\XXX\AppData\Local\Temp\XXXXX',或报fatal: remote error: upload-pack: not our ref XXX——这基本是vcs/里某个裸仓库的refs/或objects/损坏,而Composer仍试图复用它。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 先定位问题仓库:看
composer update -v输出末尾,找类似Cloning https://github.com/symfony/console.git或Checking out git@github.com:myorg/private-lib.git的行 - 进
%APPDATA%\Composer\Cache\vcs\,按域名或仓库名模糊搜索:dir /s /b *symfony*console*或Get-ChildItem "$env:APPDATA\Composer\Cache\vcs" -Recurse -Filter "*private-lib*" - 直接删整个匹配的子目录(例如
github.com-symfony-console.git\),别只删里面个别文件——Git裸仓库不支持局部修复 - 删完立刻重试
composer update,Composer会重新克隆,且自动跳过已存在的objects/(如果网络层没坏)
什么时候该整删vcs/,什么时候不能碰
vcs/缓存本质是“可重建的中间产物”,删它不会丢元数据或破坏锁文件,但会影响首次拉取速度。是否要删,取决于场景:
- CI/CD部署时建议整删:
rm -rf "$env:APPDATA\Composer\Cache\vcs\*"(PowerShell),避免不同分支构建污染彼此的origin/HEAD指针 - 本地开发中频繁切换
dev-master或dev-feature/xxx分支时,保留vcs/能显著提速,因为git fetch --depth=1复用已有对象 - 绝对不要删
repo/来“解决VCS问题”——它存的是Packagist索引,和Git克隆无关;误删会导致下次update卡在Downloading packages.json长达数十秒 - 如果项目用了私有GitLab/GitHub Enterprise,且URL含端口(如
git.myorg.com:8022),注意vcs/目录名会把:转成-(变成git.myorg.com-8022-username-repo.git),搜索时得按这个规则来
PowerShell里删VCS缓存的实操细节
Windows用户容易在PowerShell里栽跟头:直接写rm -rf $(composer config --global cache-dir)\vcs\会失败,因为composer config输出带换行或空格,$()不自动Trim。
- 安全写法是分两步:
$cache = (composer config --global cache-dir).Trim(); Remove-Item "$cache\vcs" -Recurse -Force - 或者绕过变量,硬编码路径:
Remove-Item "$env:APPDATA\Composer\Cache\vcs" -Recurse -Force - 删完验证是否真清了:
Get-ChildItem "$env:APPDATA\Composer\Cache\vcs"应返回空,而不是Path not found(后者说明路径写错) - 如果执行时报
Access is denied,右键vcs文件夹 → 属性 → 安全 → 编辑 → 勾选当前用户“完全控制”,再重试
Extracting流程,也不影响dist.sha256校验,但它会悄悄覆盖你认为“已经重装”的dev版本——因为Composer优先从vcs/里git archive打包,而不是重新下载ZIP。这点最容易被忽略。

















