composer.lock必须提交到git且不能被.gitignore排除——它是依赖一致性的强制契约，缺失会导致composer install退化为update，引发环境漂移、ci失败和线上故障。
composer.lock 文件缺失或未提交
多人协作时最常踩的坑：有人 git commit 漏掉了 composer.lock，或者它被误加进 .gitignore。结果别人 git clone 下来直接跑 composer install，发现锁文件不存在——Composer 就自动 fallback 到 update 行为，版本不一致、环境漂移、CI 构建失败全由此起。
- 确认方式：
ls -l composer.lock，不存在就不是网络问题，是交付缺陷 - 修复动作：删掉
vendor/，让负责人重新运行composer install（确保其环境合规），再git add composer.lock && git commit - 预防手段：在 CI 脚本开头加一行
test -f composer.lock || { echo "ERROR: composer.lock missing"; exit 1; }
PHP 版本或扩展不一致
composer.lock 里记录的是某台机器上“能跑通”的精确依赖组合，但它隐式依赖 PHP 小版本、扩展启用状态和 platform 配置。A 同学用 PHP 8.2 + ext-mbstring 装成功，B 同学本地是 PHP 8.1 且没开 mbstring，composer install 就会报 Your requirements could not be resolved——这不是冲突，是环境断层。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查命令：
php -v、php -m | grep -E "(mbstring|xml|curl|zip)" - 别信
composer.json里的"require": {"php": "^8.1"}，真正卡死的是composer.lock中某个包实际要求的最低 PHP 版本（比如monolog/monolog v3.5.0要求PHP >=8.1，但symfony/console v6.4可能要PHP >=8.2） - 团队必须统一声明底线：
"config": {"platform": {"php": "8.2.10"}}写进composer.json，并把它当作环境契约
vendor/ 目录权限被污染
有人不小心用了 sudo composer install，或者 CI 脚本里混了 root 权限操作，导致 vendor/、composer.lock 或 ~/.composer 归属变成 root。之后普通用户再执行 composer install，就会卡在 file_put_contents(/path/to/vendor/autoload.php): Permission denied。
- 定位命令：
ls -ld vendor/ composer.lock，看 Owner 是否为当前用户 - 修复命令：
sudo chown -R $(whoami):$(whoami) vendor/ composer.lock（注意别递归改错目录） - 绝对不要
chmod 777——掩盖归属问题，反而引发后续 autoload 失效或安全警告
镜像源与缓存状态不同步
团队成员各自配置了不同镜像源，或有人清过缓存、有人没清，导致同一份 composer.lock 在不同机器上还原出不同内容。尤其当锁文件里有 dist 和 source 混用时，源站响应差异会被放大。
- 验证命令：
composer config -g repo.packagist，输出必须统一为https://mirrors.aliyun.com/composer/ - 强制同步缓存：
composer clear-cache后再composer install，避免旧失败记录干扰 - CI 环境务必挂载复用
$HOME/.composer/cache，否则每次都是裸连，超时概率翻倍
composer install 的执行链倒查三层才定位到根因。
