答案是磁盘写入失败而非包损坏。Composer在sys_get_temp_dir()指向的临时目录（如/tmp或C:\Users\XXX\AppData\Local\Temp）解压时空间不足，导致zip截断、校验失败，表现为“Failed to extract”及“corrupt archive”，需检查该分区空间并清理或迁移缓存/临时目录。
Composer update 卡在 extracting 阶段报错 Failed to extract
这基本是磁盘写入失败的典型表现：Composer 在临时目录解压包时空间不足，导致 zip 文件被截断或部分写入，后续校验失败。错误信息里常带 zip archive is corrupt 或 unable to open file，但根本原因不是包本身损坏，而是本地临时解压过程被系统中止。
实操建议：
- 先用
df -h（Linux/macOS）或dir（Windows）确认sys_get_temp_dir()返回路径所在分区剩余空间 —— Composer 默认用系统临时目录（如/tmp或C:\Users\XXX\AppData\Local\Temp），不是项目目录所在盘 - 临时切换 Composer 的缓存/临时目录到空间充足的路径：
COMPOSER_CACHE_DIR=/path/to/big/disk/cache COMPOSER_HOME=/path/to/big/disk/config composer update - 别直接删
vendor/后重试 —— 残留的半解压文件可能还在composer cache里，下次 update 仍会复用坏包
清理 Composer 缓存里的损坏包文件
Composer 缓存（~/.composer/cache/files/ 或 %COMPOSER_HOME%\cache\files\）会按 vendor/name+version 哈希存压缩包。空间不足导致的损坏通常表现为 zip 文件体积异常小（比如只有几百字节），或解压时报 ZipArchive::extractTo(): Invalid or unhandled format。
实操建议：
- 运行
composer clear-cache最直接，但它会清空所有缓存 —— 如果网络慢或包源不稳定，后续 update 会变慢 - 更精准的做法：进缓存目录，用
find . -name "*.zip" -size -1024c找出小于 1KB 的 zip（正常包至少几 MB），手动删掉对应整个子目录（因为每个包含package.json+dist.zip+source/） - 验证是否真损坏：挑一个报错的包，用
unzip -t xxx.zip测试完整性；若提示missing 123456789 bytes就确认是截断文件
避免下次再因磁盘满中断更新
Composer update 是 I/O 密集型操作，尤其当有大量依赖或启用了 --with-all-dependencies 时，临时解压+重写 vendor 目录可能瞬时占用数倍于最终 vendor 大小的空间（解压中间态、旧 vendor 删除延迟等）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 执行前预留至少
vendor/当前大小 × 2.5 的空闲空间 —— 不要只看 vendor 目录，要看sys_get_temp_dir()所在分区 - 禁用 Composer 的并行解压（它默认开多线程，加剧 I/O 峰值）：
composer config -g process-timeout 3000和composer config -g use-include-path false不能解决空间问题，但加COMPOSER_DISABLE_PARALLEL=1能降低瞬时写入压力 - 对 CI/CD 环境，在
composer install前加检查脚本：df $(php -r "echo sys_get_temp_dir();") | awk 'NR==2 {if($5 > 90) exit 1}'，超 90% 使用率就中断构建
已损坏的 vendor 目录怎么安全恢复
如果 vendor/ 里已有部分目录结构混乱（比如只有 autoload.php 没有 src/）、类文件缺失或 composer.lock 与实际内容不一致，硬删重装风险高 —— 可能漏掉 require-dev 里没列在 lock 中的包，或触发 post-install-cmd 脚本异常。
实操建议：
- 优先用
composer install --no-dev --optimize-autoloader替代update—— 它只按 lock 文件还原，跳过依赖解析和下载，I/O 开销小得多 - 若必须 update，加
--no-scripts --no-plugins参数绕过钩子脚本，防止它们在不完整 vendor 上执行出错 - 千万别用
rm -rf vendor && composer update一气呵成 —— 先composer install恢复干净状态，再单独composer require xxx增量更新，更容易定位哪个包真正引发空间问题
最易被忽略的是：Composer 的 cache 和 temp 路径可能不在同一磁盘，而错误日志从不提示具体是哪个路径满了。每次看到 extracting 卡住，第一反应不该是查包源，而是立刻看 df 输出 —— 尤其注意 /tmp 分区。
