composer.lock 冲突必须用 composer update --lock 重建，不可手动修改；它是依赖树的精确快照，字段顺序、数组排列、platform 和哈希值均有语义，git 合并会破坏其完整性导致 install 失败或静默错误。
composer.lock 合并冲突不能手动解决，必须用 composer update --lock 重建。 它不是配置文件，而是依赖树的精确快照；Git 行级合并留下的标记、顺序错乱、缩进变动或 platform 字段差异，都会导致 composer install 直接失败或静默装错包。
为什么手动修 composer.lock 必然出问题
常见错误现象包括：JSON decode error: Syntax error（冲突标记未清除）、Package xyz has a mismatched hash（字段顺序或空行影响 content-hash 计算）、Invalid argument supplied for foreach()（解析失败后跳过关键结构）。更隐蔽的是：本地能跑通，CI 或线上却类找不到——因为子依赖被意外降级或 autoload 映射丢失。
根本原因在于：composer.lock 的字段顺序、packages 数组排列、platform 快照、dist.sha256 值全都有语义。它不是“写给人看的 JSON”，而是 Composer 运行时校验契约的二进制等价物。
- Git 冲突标记（
）本身就会让 PHP <code>json_decode()报错 - 删空行、调缩进、拼接两方
packages条目 → 破坏content-hash，后续composer install拒绝执行 - 保留一方内容但
composer.json已变更 →Your lock file does not contain a compatible set of packages
冲突发生时该运行哪条命令：只用 composer update --lock
composer install 是“按 lock 装”，要求 lock 文件合法且匹配当前 composer.json；而 composer update --lock 是“按 json 重算 lock”，不读旧 lock，只基于当前 composer.json 生成新快照——这才是冲突场景下唯一安全的操作。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操步骤如下：
- 先确保
composer.json已无冲突（可用git checkout --theirs composer.json或手动整合） - 删掉当前冲突的
composer.lock（或先mv composer.lock composer.lock.bak） - 运行
composer update --lock→ 正常输出应为Lock file operations: 0 installs, 0 updates, 0 removals - 若输出中出现大量
Updating xxx，说明composer.json还没拉齐，需先git pull origin main并重试
团队协作中怎么减少假冲突和误操作
很多冲突其实源于格式扰动而非语义差异。启用 "sort-packages": true 可强制 Composer 固定 packages 数组顺序，大幅降低因安装顺序不同引发的“假冲突”。
预防要点：
- 在
composer.json的config段加入"sort-packages": true，再执行一次composer update --lock提交新格式 - 所有依赖变更必须先改
composer.json，再立即执行composer update --lock，然后一起提交 - CI 脚本里禁用
--no-lock：用composer install --no-interaction，不是composer install --no-lock - 把
composer.lock加进 PR 模板 checklist，强制人工确认是否已重建
真正麻烦的从来不是“怎么修”，而是“谁在什么时机触发了重写”。只要有人在本地跑了一次 composer install 或 composer update，就可能带入 PHP 版本、平台约束或嵌套顺序的差异——这些细节不会报错，但会让 lock 文件失去可复现性。
