Composer安装过程中中断如何继续安装

先说说我这几年的经验：Composer 安装半路中断，直接重来一遍究竟能不能行？答案其实没那么绝对——得看你是哪种“翻车”。

直接跑 composer install 或 composer update 确实能解决不少情况，但这有个大前提——你不能遇到 ZIP 损坏、installed.json 被写一半截断、或者内存溢出直接把进程干趴了。否则你会发现，机器每次都卡在同一个包上，像中了“复读机”诅咒。

为什么重试有时有效，有时无效

Composer 能不能“续传”，关键要看三个东西是否正常运作：composer.lock 的完整性、vendor/composer/installed.json 是否可读、还有缓存里的 ZIP 文件是否能通过校验。如果这些都没被破坏，重跑之后，Composer 会聪明地跳过那些已经解压成功的包，只盯着失败或者还没开始的包干活。

• ✅ 有效场景：网络抖了一把，某个包下载超时，临时文件被清掉了，但其他包都稳稳装好了。这时候重试，直接从下一个包走起。
• ❌ 无效场景：弹出 The zip extension and unzip command are both missing（其实背后是 ZIP 包没下全）、Invalid argument supplied for foreach()（ installed.json 被砍了个尾巴）、或者直接显示 Killed（内存不够，系统帮你强行终止了）。
• ⚠️ 最坑人的一种情况：vendor/ 目录里堆着部分包，但 installed.json 已经坏了。这种“假成功真失败”会让重试要么报错，要么悄悄跳过那些它以为已经存在的依赖——酿成大祸。

中断后必须手动清理的几种情况

一旦碰到下面这些报错，就别再傻傻重试了，赶紧动手清理：

• Failed to extract vendor/package-name: unable to open archive → 确认 ZIP 坏了，删掉 vendor/ 整个目录，再去 ~/.composer/cache/files/ 里找到对应的包一并清掉。
• Invalid argument supplied for foreach() 或者解析 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/——说实话，比什么重试参数都管用。
• 极端慢网络还有一个绝招：先用 wget -c 手动把对应的 dist ZIP 拉下来，然后放到 ~/.composer/cache/files/vendor/name/xxx-sha256.zip 里。Composer 会自动认出它，直接跳过下载环节。

真正容易被忽略的关键点

很多人觉得中断了“继续”就是等着 Composer 自己恢复，但往往瓶颈在于接入的是 packagist.org 还是阿里云镜像、cache-dir 是否可写、vendor/ 的目录权限有没有被 IDE 或者杀毒软件怼住，Windows 下还可能有长路径的变态限制。这些因素比重新下载一次更隐蔽，更容易把所谓的“续传”变成新一轮灾难。