composer.lock 必须提交到 Git，否则各环境解析版本约束不一致将引发兼容性问题；应禁用 .gitignore 排除、精确锁定包版本、更新时用 --minimal-changes、冲突时执行 composer update --lock 修复。
composer.lock 文件必须提交到 Git
不提交 composer.lock，就等于放弃版本锁定。所有开发机、CI 环境、生产服务器都会各自解析 composer.json 中的版本约束（比如 "^2.0"），结果可能拉到不同小版本甚至次版本，引发兼容性问题。
常见错误现象：composer install 在本地跑通，部署后报 Class not found 或方法不存在——大概率是 lock 文件没提交，或被 .gitignore 误排除。
- 检查是否在
.gitignore里写了composer.lock（别写） - 首次提交后，运行
git ls-files | grep composer.lock确认已跟踪 - 团队应约定：任何依赖变更（
require/remove/update）后，必须连同更新后的composer.lock一起提交
用纯版本号锁定特定包，阻止自动升级
想让某个包永远不更新？别指望 --exclude 或配置开关——Composer 没这功能。真正可靠的方式，是把它的版本号写成不含运算符的精确值。
例如把 "nesbot/carbon": "^2.60" 改成 "nesbot/carbon": "2.85.0"，之后执行 composer update nesbot/carbon 也不会动它；composer outdated 虽仍会提示有新版，但不会触发安装。
- 改完
composer.json后，删掉vendor/和旧composer.lock，再运行composer install重建锁文件 - 如果保留旧 lock 文件，Composer 可能沿用之前解析出的依赖树，导致“写死版本”形同虚设
- 适合场景：核心基础包（如
symfony/console）、存在已知兼容问题的第三方 SDK、或灰度验证中需长期冻结的模块
更新依赖时避免连锁升级，用 --minimal-changes
默认 composer update 会尝试把整个依赖树推到最新兼容版本，容易引发意料外的间接升级（比如更新 A 导致 B 升级到不兼容的 3.x）。从 Composer 2.2 起，--minimal-changes 是更安全的选择。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
它只更新“必须变”的包：比如你显式执行 composer update monolog/monolog，它只会升 monolog 及其直系依赖中因版本冲突不得不升的部分，其余保持原样。
- 推荐日常开发使用：
composer update monolog/monolog --minimal-changes - CI 流水线中若需全量更新，仍建议先
composer outdated审查，再人工确认范围 - 注意：该选项不改变
composer.json的约束写法，仅影响 update 时的求解策略
解决 composer.lock 合并冲突的正确姿势
多人协作时，composer.lock 经常出现 Git 冲突，比如 >>>>>> 分支标记。直接手动删掉冲突标记并保留某一边？危险——哈希值和依赖关系很可能错乱。
正确做法是交还给 Composer 重新生成：
composer update --lock
这个命令不读取 composer.json 的变更，只根据当前 lock 文件内容重算哈希、校验完整性、修复结构，输出干净的新 lock 文件。
- 执行前确保
composer.json已是最终合并结果（即无冲突） - 如果冲突源于不同分支修改了同一包的版本约束，先人工协调好
composer.json再运行该命令 - 切勿在生产部署流程中跳过 lock 文件校验——哪怕只是多了一行空格，
composer install在 Composer 2.5+ 会直接报错退出
