composer安装中断后直接失败，因vendor/与composer.lock状态不一致，导致content-hash校验失败；应先用composer install --no-scripts --no-plugins补全vendor，再dump-autoload；仅当此法失效且composer.json确认无误时，才删lock并用composer update --lock重建。
Composer 安装中断后再次运行报错，不是“锁文件坏了”，而是 composer.lock 和本地 vendor/ 目录状态不一致，导致依赖解析器拒绝继续——它宁可卡住，也不愿装出不可复现的环境。
为什么中断后 composer install 直接失败
Composer 不是简单解压包，它在安装过程中会分阶段写入：vendor/ 目录逐步填充、composer.lock 最后校验、autoload 文件最后生成。中断时很可能停在中间态：某些包已写入 vendor，但 autoload.php 还没重写，lock 文件里的哈希也和当前目录不匹配。
此时再跑 composer install，它会比对 lock 文件声明的 content-hash 和实际 vendor/ 内容，发现不一致就直接退出，报类似 Package xyz has a mismatched hash 或静默失败。
- 别信
rm -rf vendor && composer install能解决问题——如果composer.lock本身是旧版或环境不一致，重装只会复现同样问题 -
composer update更危险：它会尝试重算整棵树，可能把已装好的稳定包升级到不兼容版本 - 中断常发生在网络抖动、磁盘满、Ctrl+C 强制退出，甚至 PHP 内存溢出（尤其
composer update时）
中断后第一反应：用 composer install --no-scripts --no-plugins
这个组合不是“跳过检查”，而是让 Composer 先绕过 autoload 生成和脚本执行，专注把 vendor/ 目录按 composer.lock 补全干净。只要 lock 文件合法、PHP 版本匹配、扩展齐全，它就能完成“补漏”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 成功后，再单独运行
composer dump-autoload重建自动加载映射 - 如果仍报 hash 不匹配，说明
composer.lock已被部分写入或损坏，不能信任——这时才该删 lock 并重建 - 加
--no-plugins是防某些插件（如hirak/prestissimo）在中断时残留异常状态
何时必须删 composer.lock 并重建
只有当 composer install --no-scripts --no-plugins 也失败，且确认 composer.json 是最终期望状态时，才走这步。重建不是靠 composer install，而是靠 composer update --lock。
- 先
rm composer.lock（或备份后删） - 确保
composer.json已同步最新（git checkout -- composer.json或手动核对） - 运行
composer update --lock—— 它不碰vendor/，只基于当前composer.json生成新 lock 文件，content-hash 必然合法 - 再跑
composer install，这次会按新 lock 完整安装
预防下次中断：控制内存与并发
Composer 默认启用并行下载，但中断高发场景（如 CI、低配开发机）往往因内存爆掉或连接池耗尽。不用改全局配置，单次命令就能压稳：
- 加
--no-cache避免缓存写入中途失败（尤其挂载卷权限不一致时） - 限制并发：
COMPOSER_PROCESS_TIMEOUT=600 COMPOSER_MEMORY_LIMIT=-1 composer install，其中-1表示不限制内存，600是超时秒数（默认 300，不够大项目） - CI 中固定 PHP 版本路径调用，避免系统默认 PHP 变动干扰：
/usr/bin/php8.2 composer install
真正麻烦的从来不是中断本身，而是中断后你不确定 vendor/ 里哪些包是半成品、哪些 autoload 映射已失效——所以每次中断，都要当成一次环境契约的重新确认，而不是简单重来。
