必须提交composer.lock，否则多人环境必然不一致；缺失时composer install退化为update，导致版本漂移、class not found及package未安装等故障，根本原因是lock文件未进git或被.gitignore错误过滤。

必须提交 composer.lock，否则多人环境必然不一致——这不是建议，是硬性前提。

为什么本地能跑，上线就报“Class not found”或“package x is not installed”

根本原因是 composer.lock 没进 Git，或者被 .gitignore 错误过滤了。一旦缺失，composer install 会退化为 composer update 行为：它不再还原已知状态，而是重新解析 composer.json 并安装最新兼容版本，结果不可控。

• CI/CD 流水线拉代码后执行 composer install，发现 vendor 目录空或残缺，八成是 lock 文件没提交
• 新同事 clone 项目后直接 composer install 失败，先 ls -l composer.lock 确认文件是否存在
• IDE 自动生成的 .gitignore 模板有时会误加 composer.lock，检查 Git 跟踪状态：git check-ignore -v composer.lock

提交前必须验证的三件事

不是“写完代码就 git push”，lock 文件提交前要确认它真实反映当前可运行状态。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 运行 composer install 成功且无警告（尤其注意 “Warning: The lock file is not up to date”）
• 执行 composer dump-autoload 后，所有类能正常加载——别等上线才发现 autoload 映射错位
• 检查 composer.lock 里关键包的 version 和 source.type 是否合理：比如私有包应为 "type": "zip" 或 "type": "vcs"，而非 "type": "package" 这种手工定义方式

团队协作中最容易被忽略的 autoload 同步问题

改了 composer.json 里的 autoload 配置，却不运行 composer dump-autoload，会导致类找不到，但错误信息只显示 Class 'Xxx' not found，完全不提示配置问题。

• PSR-4 映射路径必须相对于项目根目录，不能写 "src/" 却实际把文件放在 src/Utils/Str.php，而声明的是 "App\": "src/" —— 此时 AppStr 就永远找不到
• 修改 autoload 后，composer install 和 composer update 都不会自动触发重生成 autoload 文件，必须手动跑 composer dump-autoload
• 如果用了 --optimize-autoloader（如 CI 中），本地开发也建议统一加这个参数，避免 classmap 和 psr-4 行为不一致

真正麻烦的从来不是报错本身，而是错误信息不指向真实原因：lock 文件缺失、autoload 路径错位、platform 版本硬编码——这些都藏在表层报错之下，需要按顺序逐项排除。