composer.lock解析失败应先运行composer validate：若报json decode error等则确为损坏，需按vendor状态选择composer update --lock或重装；若提示“not up to date”则属过期，非损坏。
composer.lock 解析失败时先跑 composer validate
报错如 JSON decode error、Invalid argument supplied for foreach() 或直接卡在 autoload 加载阶段，大概率是 lock 文件 JSON 结构损坏或字段缺失。这时候别急着删文件，先用 composer validate 快速验证：composer validate 不联网、不读包、不碰 vendor，500ms 内就能告诉你 lock 是否合法。如果提示 The lock file is not up to date，那不是损坏，只是过期——该跑 composer install 或 composer update --lock，而不是修文件。
手动删了 composer.lock 后不能直接 composer install
composer install 的语义就是“按 lock 精确还原”，lock 不存在时，Composer v2.5+ 会直接报错 Command "install" is not defined；旧版可能静默失败，但结果不可控。正确做法只有两个：
- 如果 vendor 目录完整且没动过，运行
composer update --lock—— 它只重写 lock，不升级任何包，输出里应看到Lock file operations: 0 installs, 0 updates, 0 removals - 如果 vendor 已损坏或不确定是否一致，先
rm -rf vendor，再执行composer install（此时 Composer 会基于 composer.json 自动重建 lock 并安装）
composer update 和 composer update --lock 的关键区别
这两个命令都生成 lock 文件，但行为完全不同：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer update：重新解析所有约束，查最新兼容版本，升级包并写入 lock —— 会改依赖树，可能引入 BC break -
composer update --lock（v2.2+）：只对齐 lock 与当前 vendor 状态，不装/不卸/不升级，version 和 dist.reference 全部保持原样 - 注意：
--lock不校验 platform（比如 PHP 版本），也不检查 require-dev 是否满足；它只做快照同步
Git 冲突或换行符导致的“假损坏”怎么识别
常见于 Windows 与 Linux 协作、或合并 PR 后 lock 文件被标为 modified 但内容看似正常。先看 git status，再用 composer validate 确认是否真损坏。如果 validate 通过但 Git 显示冲突残留（比如 cat composer.lock | head -n 5 显示乱码或空行，很可能是换行符或磁盘写入中断所致。这种情况下不要手修，优先 git checkout -- composer.lock 回退，或 composer update --lock 重建。
真正麻烦的是 vendor/autoload.php 路径引用正确、文件物理存在，但类仍加载失败——这往往意味着 lock 里记录的 autoloading 配置已错乱，而 validate 检不出。此时最稳的路径是删 vendor + 删 lock + composer install，哪怕多花两分钟。
