因为 composer 的 repo/ 目录缓存了旧源的 packages.json 快照，即使已切换镜像配置，不清缓存仍会复用旧元数据，导致看不到新版本或找不到新包；清前须确认真实路径、缓存大小及无进程占用，再用 --no-interaction 安全执行，并注意 composer.lock、cdn 延迟和项目级配置等干扰项。
为什么切了镜像还要清缓存？
因为 Composer 的 repo/ 子目录里存着旧源的 packages.json 快照，哪怕你已经执行 composer config --global repo.packagist 换成腾讯云或阿里云地址，只要缓存没清，Composer 仍可能复用本地旧元数据——结果就是 composer update 看不到新版本、composer require 找不到刚发布的包。
清缓存前必须确认三件事
盲目运行 composer clear-cache 可能白忙活，甚至引发后续错误：
- 先查真实路径：
composer config --global cache-dir—— 输出路径才是实际操作目标，不是“默认路径” - 再看大小：Linux/macOS 执行
du -sh $(composer config --global cache-dir)；Windows 直接打开资源管理器访问%APPDATA%\Composer\Cache查“属性” - 确认无后台进程占用：Linux/macOS 运行
lsof +D $(composer config --global cache-dir)；Windows 用handle.exe -p php.exe查是否被 PHP 进程锁住
执行清缓存的正确姿势
composer clear-cache 是标准命令，但直接运行在 CI 或无 TTY 环境下会卡住：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 预检（不删文件）：
composer clear-cache --dry-run—— 确认将删路径是否符合预期 - 正式执行：
composer clear-cache --no-interaction—— 避免因交互提示阻塞自动化流程 - 手动补刀（尤其大项目）：
rm -rf ~/.composer/cache/vcs/*（Linux/macOS）或rd /s /q "%APPDATA%\Composer\Cache\vcs"（Windows），因为vcs/单个 Git 裸仓就能占 500MB+，而clear-cache在某些旧版中默认跳过它
清完缓存还装不到新包？别急着重试
缓存清了 ≠ 版本自动升级，常见干扰项比缓存本身更关键：
-
composer.lock文件存在 →composer install必然还原旧依赖树，和缓存无关 - 镜像源 CDN 有延迟 → 阿里云/腾讯云通常 5–10 分钟同步一次
packages.json，刚发布的新包等一会儿再试 - 项目级配置覆盖全局 → 进项目目录运行
composer config repo.packagist，若输出非空，说明composer.json里的"repositories"字段仍在生效 - 环境变量劫持 → 检查是否设置了
COMPOSER_REPO_PACKAGIST，Linux/macOS 用unset COMPOSER_REPO_PACKAGIST，Windows 用set COMPOSER_REPO_PACKAGIST=
最易被忽略的是：清完缓存后首次 composer install 会重新下载所有 .zip 包，网络波动时容易卡在某个大包（比如 laravel/ui），这不是失败，是正常流程。真正要盯的是 HTTP 请求是否发往镜像域名——跑 composer install -vvv | grep -i 'GET https' 才算验证到位。
