Composer lock文件冲突本质是依赖树快照不兼容：不同分支对同一包升级了不可合并的精确版本，导致JSON节点级冲突，必须人工协调composer.json后执行composer update --lock重生成。
Composer lock 文件冲突的本质是什么
composer.lock 不是普通配置文件，它是依赖树的完整快照：每个包的精确版本、哈希值、require 关系、安装路径全被固化。Git 合并时只要两个分支对同一包升级了不同版本（哪怕只是 monolog/monolog 从 2.10.0 升到 2.10.1 和 2.11.0），lock 文件就会产生结构化冲突——不是某几行文本打架，而是整个 JSON 节点不兼容。
- 冲突不是“谁改得多”，而是“谁的依赖图最终能通过
composer install” - 直接手动删冲突标记、保留一方内容大概率导致
composer install报错或装错包 -
composer update不解决合并冲突，它只基于当前composer.json重生成 lock，可能覆盖他人已确认的依赖
用 composer merge-plugin 还是手动 resolve
composer-merge-plugin 已废弃（自 Composer 2.2+ 官方不推荐），且它只处理 composer.json 合并，对 composer.lock 无能为力。现在唯一可靠路径是人工介入 + 工具辅助：
- 先放弃「自动合并 lock」幻想，把它当二进制文件对待：Git 中设
.gitattributes规则，让 lock 文件不参与自动合并*composer.lock -merge
- 出现冲突时，立刻执行
git checkout --ours composer.json或--theirs，选一个更接近你当前开发目标的composer.json版本 - 然后运行
composer update --lock（不是composer update）——它只更新 lock 文件，不改 vendor，也不重新解析composer.json的 require 字段 - 如果提示 “Your requirements could not be resolved”，说明两个分支的
composer.json存在真实不兼容（比如 A 要php: ^8.1，B 要php: ^8.2），必须先协调composer.json再重试
为什么不能直接 composer install 跳过冲突
composer install 严格校验 lock 文件完整性：它会逐行比对 vendor 中每个包的 dist.sha256 和 lock 里记录的是否一致。一旦 lock 文件含 Git 冲突标记（如 <<<<<< HEAD），PHP JSON 解析器直接报错：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
JSON decode error: Syntax error
- 更隐蔽的问题是：如果侥幸跳过语法错误（比如你手删了冲突标记但没修 JSON 结构），
composer install可能静默降级某些包，导致运行时行为不一致 - CI 流水线中若未校验 lock 文件合法性（例如没加
composer validate --strict），问题会延迟暴露到上线后 - 某些 IDE 插件或部署脚本会预读 lock 文件做分析，非法 JSON 会导致它们崩溃或误判
团队协作中真正该卡住的环节
锁文件冲突暴露的从来不是 Git 操作问题，而是依赖管理流程断点：
- 所有
composer update必须带具体包名（如composer update symfony/console），禁止裸跑composer update—— 否则 lock 文件变更不可追溯 - PR 检查项里加一条：
composer validate --strict && git diff --quiet composer.lock，确保提交前 lock 是合法且无意外变更 - 如果项目长期多人高频改依赖，考虑把
composer.json拆成composer.base.json+composer.local.json，用composer-merge-plugin（仅用于 json 合并）管控基础依赖，lock 仍由主文件统一生成
lock 文件不是用来“合并”的，是用来“共识后重生成”的。最省事的方式，永远是让所有人先对齐 composer.json，再一起跑一次 composer update --lock。
