“lock file is not up to date”是因为composer.json与composer.lock内容不一致，Composer拒绝安装以保障依赖可重现；常见原因包括手动修改json未同步lock、git合并漏提lock、CI中lock损坏等。
为什么 composer install 会报 “lock file is not up to date”？
因为 Composer 在执行 composer install 时，会严格比对 composer.json 和 composer.lock 中的依赖声明与哈希值。只要两者不一致（比如你手动改了 composer.json 但没更新 lock），它就拒绝安装，而不是自动修复——这是保护可重现部署的强制机制。
常见触发场景：
- 直接编辑
composer.json（如改版本号、增删包），却忘了运行composer update或composer update --lock - 多人协作中，有人提交了新
composer.json但漏提composer.lock，或提交了旧 lock - CI/CD 流水线里用了
composer install --no-interaction，但环境里 lock 文件已损坏或被覆盖
composer update 和 composer update --lock 有什么本质区别？
前者会重新解析所有依赖、执行完整安装逻辑（包括下载、解压、生成 autoloader），并更新 composer.lock；后者只重写 lock 文件，不碰 vendor 目录，也不下载任何包——它只是让 lock “对齐”当前 composer.json 的声明（比如 require 版本范围、平台配置等）。
什么时候该用哪个？
- 想升级某个包（或全部） → 用
composer update（可加包名限定） - 只是修正 lock 与 json 的结构差异（如改了
platform配置、minimum-stability），且确定 vendor 已是最新的 → 用composer update --lock - CI 环境中发现 lock/json 不一致但不想触发真实安装 →
composer update --lock --dry-run先验证
Hash 不一致时，怎么快速定位是哪部分导致的？
Composer 的 hash 是基于整个 lock 文件内容（不含注释和空白行）计算的 SHA256。真正影响 hash 的，不只是包列表，还包括：
-
content-hash字段：由composer.json的关键字段（require、require-dev、autoload、platform 等）生成 -
packages和packages-dev下每个包的dist.shasum（即压缩包实际校验和） - PHP / 扩展版本约束（
platform）、Composer 自身版本（composer-plugin-api）
所以如果 composer install 报错，先运行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer show --outdated
再对比：
composer config --list | grep platform
确认本地 platform 是否和 lock 里记录的一致（尤其在 Docker 或多 PHP 版本环境下容易出问题）。
Git 合并冲突后 lock 文件损坏怎么办？
别手动修 lock —— 它是机器生成的 JSON，格式/顺序/缩进都敏感，手改极易引入不可见错误（比如末尾多逗号、字段顺序错乱），导致后续 install 失败或 hash 不匹配。
安全做法只有两个：
- 放弃冲突后的 lock，用当前分支的
composer.json重新生成：composer update --lock --no-install - 如果知道哪边的 lock 更可信（比如主干分支），直接
git checkout main -- composer.lock，再composer install验证是否能过
顺带一提：composer.lock 必须进 Git，但建议在 .gitattributes 里加一行：composer.lock -diff，避免 Git 做文本合并，减少冲突概率。
