答案：需先区分损坏类型再针对性处理。zip损坏则清缓存+删vendor+--no-cache --force-checksums重装；installed.json截断则删该文件后--no-plugins重建；哈希不匹配则备份后运行composer update --lock更新锁文件。
直接删 vendor/ 并清缓存不是万能解法，但对绝大多数“文件损坏”报错最有效——关键得先分清是缓存 ZIP 损坏、installed.json 截断，还是 composer.lock 与实际内容哈希不匹配。
Failed to extract vendor/package: unable to open archive 怎么处理
这不是 PHP 缺 zip 扩展，而是 ~/.composer/cache/files/ 下某个 ZIP 文件本身损坏（比如下载中断、镜像同步滞后、磁盘写入异常），Composer 校验 SHA256 失败后拒绝解压，且不会自动重试。
- 先运行
composer clear-cache，清掉所有缓存 ZIP - 再删
vendor/：rm -rf vendor（Linux/macOS）或rmdir /s vendor（Windows） - 确认镜像生效：
composer config -g repo.packagist输出必须是完整 JSON，URL 末尾带/（如"https://mirrors.aliyun.com/composer/"） - 最后执行
composer install --no-cache --force-checksums：跳过缓存 + 强制校验双保险
Invalid argument supplied for foreach() 错误怎么修
这几乎总是因为 vendor/composer/installed.json 被写到一半就中断，JSON 结构断裂。Composer 启动时读它遍历已装包，空或残缺内容直接崩。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉它：
rm -f vendor/composer/installed.json - 再跑
composer install --no-plugins，让 Composer 重建该文件 - 如果删完还报错，说明
vendor/里已有部分包目录残留但不完整（比如只有src/没有composer.json），此时必须清空整个vendor/ -
composer validate只验composer.lock，对installed.json完全无效
为什么换镜像源后仍报损坏
换镜像本身不增加校验能力，所有官方镜像都同步 Packagist 的 dist.sha256 值。真正起作用的是 --force-checksums ——它让校验失败时立刻退出，不尝试解压损坏 ZIP，防止污染 vendor/。
-
--force-checksums是必须显式加上的安全开关，不会写入配置，也不会继承到 CI 环境 - 镜像 URL 必须以
/结尾，少一个斜杠就会拼出/packages.json→ 404，命令不报错但配置静默失效 - 项目根目录若有
composer.json里的repositories字段，全局镜像配置会被彻底忽略 - CI 中常见静默失效：字段名拼错、URL 少斜杠、
repositories格式错误，都会让 Composer fallback 到官方源
composer.lock 与 vendor 内容哈希不匹配怎么识别和修复
现象是 composer install 静默跳过、没报错，但运行时类找不到或行为异常；或者 composer install --dry-run 显示反复尝试下载已存在的包。本质是 composer.lock 记的 dist.sha256 和 vendor/ 里真实文件算出的哈希对不上。
- 先备份当前
vendor/和composer.lock - 运行
composer update --lock：它只重写composer.lock中的哈希和size字段，不改动任何已安装包，也不重算依赖 - 若某包提示
dist not found，说明该版本在镜像源中已被移除，需查composer show vendor/package确认可用版本 - 切勿直接删
composer.lock——这会让 Composer 重解整个依赖图，可能引入未测试的子依赖组合
最容易被忽略的点是：CI 流水线里 vendor/ 目录缓存是高危操作，不同 PHP 版本、扩展启用状态（如 xdebug）、甚至不同 OS 下生成的 autoloader 不能混用。应该只缓存 ~/.composer/cache，并设置 COMPOSER_CACHE_DIR，而不是缓存 vendor/ 本身。
