zip包损坏是根本原因，表现为unable to open archive等错误；需定位坏包、清缓存、用--no-cache --force-checksums重装，而非删vendor或改配置。
报 Failed to extract vendor/package: unable to open archive，基本可以断定是 ZIP 包损坏，不是 PHP 缺 zip 扩展，也不是代码写错了——是 Composer 从镜像源下载时被截断，缓存里存了个坏包，解压直接崩。
怎么确认真是 ZIP 损坏，不是其他问题？
错误信息里明确带 unable to open archive、Content-Length mismatch 或 Corrupted zip file，就是 ZIP 损坏的典型信号。它和 Class not found、Invalid argument supplied for foreach() 无关，后者多是 installed.json 截断或 vendor 目录残留导致的连锁反应。
- 运行
composer install -v，盯住最后一段输出：如果卡在Extracting archive (zip)后立刻报错，且路径指向某个具体包（如symfony/console），那就是它 - 别急着删整个
vendor/——先看错误里写的包名，去缓存目录找对应 ZIP 文件，手动删掉更准 -
php -r "new ZipArchive();"能成功执行，说明zip扩展已加载；如果失败，才是环境问题，不是包损坏
清缓存 + 强制校验必须一起用
--force-checksums 不是可选开关，是必须显式加上的安全兜底。Composer 默认只校验缓存命中时的 SHA256，但一旦缓存里存了坏包，它不会自动跳过或重拉，而是硬解——失败就卡死。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先执行
composer clear-cache，清掉~/.composer/cache/files/下所有 ZIP - 再删
vendor/（Linux/macOS：rm -rf vendor；Windows：rmdir /s vendor） - 确认镜像 URL 生效：
composer config -g repo.packagist输出必须是{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，末尾斜杠不能少 - 最后跑
composer install --no-cache --force-checksums：跳过缓存 + 强制校验双保险
为什么换镜像后还报损坏？配置可能根本没生效
很多人执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就以为搞定了，但实际常被项目级配置覆盖或 URL 拼接出错。
- 项目根目录
composer.json里若定义了"repositories"字段，会彻底忽略全局镜像配置 - URL 少了末尾
/，拼出来变成https://mirrors.aliyun.com/composer/packages.json→ 404，命令不报错但静默失效 - CI 环境（如 GitHub Actions）中没在 workflow 里显式运行配置命令，全局设置根本没写进去
- 验证是否真生效，只看两个地方：
composer config -g repo.packagist的输出，或composer diagnose结尾是否提示overriden by custom repo
删 installed.json 不能解决解压失败，但能避免误判
Invalid argument supplied for foreach() 错误几乎全是 vendor/composer/installed.json 被写到一半中断导致的 JSON 断裂。它和 ZIP 解压失败无关，但容易让人混淆排查方向。
- 遇到这个错，直接删掉它：
rm -f vendor/composer/installed.json - 再跑
composer install --no-plugins让 Composer 重建该文件 - 如果删完还报错，说明
vendor/里已有不完整包（比如只有src/没composer.json），此时必须清空整个vendor/ -
composer validate只验composer.lock，对installed.json完全无效，别指望它发现问题
真正卡在解压环节的，核心就三件事：定位坏包、清对应缓存、用 --no-cache --force-checksums 重装。其他操作——比如改 composer.json、升级 Composer 版本、调 http.timeout——对 ZIP 损坏类错误基本无效。
