升级composer后需手动清理缓存，因无版本隔离机制；必须执行composer clear-cache、rm -rf vcs/目录、删除repo/https---packagist.org/*.json三步，否则易现解析失败或corrupted cache file报错。
升级 Composer 本身（如从 2.5.x 升到 2.6.x）后，composer clear-cache 不会自动清理“上一代缓存”，因为 Composer 没有版本感知的缓存隔离机制——它只按路径存文件，不按自身版本打标签。所谓“上一代缓存”实际是旧版 Composer 写入、新版仍能读取的同一套缓存结构，但某些元数据格式或压缩策略变更可能导致兼容性问题，比如 Corrupted cache file 报错或 update 卡在 repo 解析阶段。
为什么升级后要手动清缓存？
新版 Composer 可能改写缓存结构（如 2.5 → 2.6 调整了 repo/ 下 provider 文件的序列化方式），而旧缓存残留会引发静默解析失败或反复重试。这不是每次升级都必须做，但若出现以下现象，就该清：
-
composer update卡在Loading composer repositories...超过 30 秒 - 执行
composer show monolog/monolog报Could not load package monolog/monolog in https://packagist.org，但网络正常 -
composer diagnose提示Cache directory is not writable或Corrupted cache file
清哪几个目录才算真正“清理上一代”？
不能只靠 composer clear-cache —— 它默认跳过 vcs/，且不强制刷新远程元数据索引。你得组合清理三处：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer clear-cache：清掉files/（zip 包）、repo/（packages.json 快照）、archives/ -
rm -rf ~/.composer/cache/vcs/（Linux/macOS）或rd /s /q "%APPDATA%\Composer\Cache\vcs"（Windows）：VCS 缓存最顽固，单个 Git 裸仓库常占 500MB+ 且格式易不兼容 -
rm -f ~/.composer/cache/repo/https---packagist.org/*.json：精准删 Packagist 元数据，避免新版 Composer 误复用旧 provider 映射
CI/CD 或无交互环境里怎么安全执行？
在 GitHub Actions、GitLab CI 等场景下，composer clear-cache 默认会等待确认，直接 hang 住。必须加 --no-interaction，并前置检查路径是否真实可写：
- 先运行
composer config --global cache-dir确认路径（别信默认值，CI 镜像可能挂载 NFS） - 加
--dry-run预检：composer clear-cache --no-interaction --dry-run，看输出是否指向目标磁盘 - 若仍卡住，大概率是杀毒软件或 IDE 锁住了
cache/files/下的 zip；CI 中建议用rm -rf替代命令，绕过锁检测
真正容易被忽略的是：升级 Composer 后，cache/vcs/ 目录几乎一定需要手动删——它不被 clear-cache 覆盖，又最容易因 Git 协议变更（如弃用 TLS 1.0）导致 clone 失败，而且删完首次拉包会自动重建，完全无副作用。
