必须提交composer.lock且不能被.gitignore拦截——php应用项目依赖一致性的强制契约；验证用git check-ignore -v composer.lock，有输出即被忽略；冲突时应删lock后运行composer update --no-install重建，而非手动编辑。
必须提交，且不能被 .gitignore 拦截——这是 PHP 应用项目团队协作的底线。
为什么 composer install 会报 “No composer.lock file present”
这不是提示你“该生成一个”，而是明确告诉你：当前流程已中断。composer install 的设计定位就是「还原」，它只读 composer.lock，从不解析 composer.json 中的版本约束（比如 "^2.0"）。新项目首次初始化，必须运行 composer update（不是 install），它才会根据 composer.json 计算依赖并写入 composer.lock。误删后执行 composer install，错误信息里建议你 run "composer install" 是误导；正确做法是 composer update。
怎么确认 composer.lock 真正进了 Git
很多人以为自己提交了，其实早被 .gitignore 拦下。验证方式只有一条命令：
git check-ignore -v composer.lock
如果有输出，说明它被忽略了。常见错误包括：
-
/composer.lock（开头斜杠导致只匹配根目录，但实际路径可能带子目录） -
composer.lock（没加斜杠，可能误匹配my-composer.lock这类文件） - 行首或行尾有空格，比如
composer.lock写在全局~/.gitignore里，而非项目级
删掉所有相关行后，运行 git add -f composer.lock 强制加入暂存区。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
冲突时为什么绝不能手动编辑 composer.lock
composer.lock 不是配置文件，是依赖图的哈希快照。Git 行级合并（/<code>======）会直接破坏 JSON 结构，哪怕侥幸通过解析，也会引发静默错误：
- 保留了 A 分支的
laravel/frameworkv10.42.0，但 B 分支新增的spatie/laravel-ray在packages-dev里没写入 →composer install报The lock file does not contain require-dev information - 字段顺序被 Git 自动重排（如
name和version对调），composer validate通过，但后续composer update --lock会重写整块，掩盖真实变更 - 手动删冲突标记、凑出“看起来合理”的版本号 →
dist.sha256校验失败，类加载失败或行为异常
冲突发生后唯一安全的重建流程是：先确保 composer.json 已 clean merge；删掉本地 vendor/ 和 composer.lock；运行 composer update --no-install；确认无误后 git add composer.lock 提交。
哪些项目可以不提交 composer.lock
绝大多数 PHP 项目（Web 应用、CLI 工具、Laravel/Symfony 项目）都必须提交。只有两类明确例外：
- PHP 库（
library）项目：比如你写的是一个供别人require的 SDK，本身不直接运行，composer.json是给使用者看的约束，自己不需要lock依赖 - 依赖管理由其他工具接管的场景：例如项目用 Docker 构建 + 多阶段构建，且每个构建都强制
composer update --no-interaction --prefer-dist，同时确保基础镜像和网络环境完全可控（这种做法本身风险高，不推荐）
真正容易被忽略的是 content-hash 字段——它由 composer.json 内容生成，一旦你改了 json 却没运行 update 或 install，lock 文件就处于“逻辑不一致”状态。Git 提交时不会报错，但下次别人 install 会失败或降级。
