重试有时有效，有时无效，取决于是否发生硬失败：网络抖动时重试可跳过已成功包；但ZIP损坏、installed.json截断或内存溢出导致的失败必须手动清理vendor和缓存后重装。
直接重试 composer install 或 composer update 通常就能继续，但前提是没遇到 ZIP 损坏、installed.json 截断或内存溢出被 kill 这类硬失败——否则会反复卡在同一个包上。
为什么重试有时有效，有时无效
Composer 的“可恢复”是有条件的：它依赖 composer.lock 的完整性、vendor/composer/installed.json 的可用性，以及缓存中 ZIP 包是否校验通过。只要这些没被破坏，重跑命令会跳过已成功解压的包，只处理失败或未开始的部分。
- ✅ 有效场景：网络抖动导致某个包下载超时，临时文件被清理，但其他包已解压完成；重试后会从下一个包开始
- ❌ 无效场景：
The zip extension and unzip command are both missing（实为 ZIP 下载不完整）、Invalid argument supplied for foreach()（installed.json被截断）、Killed（内存不足被系统终止） - ⚠️ 注意：
vendor/目录里残留部分包 + 损坏的installed.json是最常见“假成功真失败”状态，此时重试会报错或静默跳过缺失依赖
中断后必须手动清理的几种情况
遇到以下错误，别再反复重试，立刻执行清理：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Failed to extract vendor/package-name: unable to open archive→ ZIP 损坏，删vendor/和~/.composer/cache/files/对应包目录 -
Invalid argument supplied for foreach()或解析installed.json失败 →vendor/composer/installed.json不完整，删整个vendor/ - 终端突然显示
Killed→ 内存溢出，先加 swap 或调高memory_limit，再删vendor/和清缓存
标准清理顺序：rm -rf vendor → composer clear-cache → 再运行安装命令。
低带宽或不稳定网络下的稳妥做法
与其等中断后补救，不如一开始就降低失败概率：
- 强制走压缩包分发：
composer install --prefer-dist（避免 git clone 大仓库） - 禁用插件减少干扰：
composer install --no-plugins（尤其旧版 Prestissimo 可能加剧并发失败） - 国内用户必须配镜像源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，这比所有重试参数都管用 - 极慢网络下可手动预置 ZIP：用
wget -c下载对应包的 dist URL，放进~/.composer/cache/files/vendor/name/xxx-sha256.zip，Composer 会自动识别并跳过下载
真正容易被忽略的关键点
很多人以为中断后“继续”就是等 Composer 自己恢复，但实际瓶颈往往不在命令本身——而是你连的是 packagist.org 还是阿里云镜像、cache-dir 是否可写、vendor/ 目录权限是否被 IDE 或杀毒软件锁定、Windows 下长路径是否触发限制。这些因素会让“续传”变成更隐蔽的失败，比重新下载还难排查。
