必须先清缓存，因Composer默认复用损坏的ZIP文件导致错误复现；执行composer clear-cache前需确认镜像配置生效、PHP SSL证书正确，并在失败后同步清理vendor/和composer.lock。
缓存损坏是 Composer 安装失败最常被忽略的底层原因，尤其在反复重试后仍报 file could not be downloaded、corrupted zip file 或 Cannot allocate memory 时，清缓存应作为第一步操作，而非最后手段。
为什么必须先清缓存？
Composer 缓存不是简单“下载完就扔”，它会把包的 zip、dist 归档、元数据甚至部分解压产物都存下来。一旦网络中断、磁盘写入异常或镜像源返回不完整响应，缓存就可能处于半损坏状态——后续 install/update 会直接复用这个坏缓存，导致错误复现，且错误信息往往不提示“缓存问题”。composer clear-cache 是唯一能彻底切断这种污染链的操作。
执行 composer clear-cache 的正确姿势
这条命令看似简单，但有几个关键点决定它是否真正生效：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须在运行安装命令前执行，而不是失败后补救（很多用户边重试边清，结果旧失败记录还在）
- 全局配置未生效时，
clear-cache仍会清理所有缓存路径，但建议配合composer diagnose确认当前环境是否真的在用你配的镜像源 - Windows 用户若用 Git Bash，
clear-cache可能因权限或路径解析失败而静默跳过，建议改用 PowerShell 或 CMD 执行 - 执行后终端会输出类似
Clearing cache (C:\Users\XXX\AppData\Local\Composer\cache)的路径，留意该路径是否存在、是否可写
清完缓存还失败？检查这三件事
缓存只是起点，不是万能解药。如果 clear-cache 后仍失败，大概率是其他环节卡住了：
- 镜像源配置键名已过时：Composer 2.2+ 废弃了
repo.packagist，改用repositories.packagist.org；错配会导致静默 fallback 到原站，composer diagnose中 “Repo:” 行显示的仍是https://packagist.org - PHP 的 SSL 根证书没配对：报
unable to get local issuer certificate不是 Composer 错，而是php.ini里curl.cainfo指向了错误路径或文件不存在；运行php --ini找到真实加载的 ini 文件再修改 - vendor/ 和 composer.lock 残留干扰：某些错误（如
proc_open failed）会在失败后留下不完整的vendor/，必须手动删掉再重来，不能只靠clear-cache
缓存本身不难清，难的是判断它是否真被清了、是否真被用了、以及清完之后该盯住哪一行诊断输出。很多人卡在第二步——以为清了，其实配置没生效，缓存还是从国外源拉的，自然还会失败。
