composer install才是同步动作，因它严格按composer.lock安装精确版本和哈希，确保字节级一致；composer update是破坏动作，会重解析composer.json、重写lock、拉取最新兼容版，易致环境不一致。
本地依赖包与线上环境不一致，不是因为没上传 composer.lock，而是因为线上执行了 composer update、漏删 vendor/、或平台要求（PHP 版本/扩展）未对齐——同步的关键是“还原”，不是“更新”。
为什么 composer install 才是同步动作，而 composer update 是破坏动作
composer install 严格按 composer.lock 安装每个包的精确版本和哈希，确保线上和本地 vendor 内容字节级一致；composer update 则会重新解析 composer.json、重写 composer.lock、拉取满足约束的最新可用版本——哪怕只改了一个 ^2.0，也可能装上 2.9.1 而非本地测试过的 2.3.4。
常见错误现象：
- CI 脚本里写了
composer update --no-dev，以为“不装 dev 就安全”，实则已悄悄升级所有生产依赖 - 本地删了
composer.lock后直接composer install，报错Your lock file does not contain the required package - 线上
vendor/是上次部署残留，install没清旧目录，导致新旧类混存、Class not found
同步前必须确认的三件事（缺一不可）
不是靠一条命令兜底，而是组合动作确保可复现：
- 删掉整个
vendor/目录：rm -rf vendor（别信dump-autoload或clear-cache能救回来） - 确认
composer.lock已提交且和开发环境完全一致（Git diff 看哈希、时间戳、dist URL 是否含私有源） - 执行
composer install --no-dev --optimize-autoloader --no-interaction：
•--no-dev跳过require-dev包，但不校验 vendor 一致性
•--optimize-autoloader生成vendor/composer/autoload_classmap.php，避免运行时遍历文件系统
•--no-interaction防止卡在 “Do you trust this repository?” 这类 prompt 上
composer.lock 里有私有源 URL，但线上机器没权限怎么办
这是 install 报 failed to download 的最常见原因，不是网络问题，而是权限错配：本地 composer.json 中 repositories 指向了公司内网 GitLab，composer.lock 记录的是该源的 dist URL，但 CI 机器或生产服务器无法访问该地址。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
解决路径只有两条：
- 把私有源配置也写进线上环境的全局 Composer 配置：
composer config -g repositories.my-private '{"type":"composer","url":"https://gitlab.example.com/api/v4/groups/my-group/-/composer"}' - 更推荐：用
composer config --unset repositories清掉本地临时源，改用path类型仓库 +scp同步包目录，或提前在 CI 机器上composer global require "squizlabs/php_codesniffer"类似方式预装
切忌加 --ignore-platform-reqs 来绕过——它跳过的是 PHP 版本和扩展检查，对源权限无效。
本地改了 composer.json，怎么让线上立刻生效
别手动 scp 文件再敲命令。正确链路是：
- 本地改完
composer.json，先跑composer update --dry-run看是否真有变更（比如新增包、升版号） - 若有变更，运行
composer update vendor/package-name（指定包）或全量composer update，生成新composer.lock - 确认
git status显示composer.json和composer.lock都已 stage，再提交 - 线上部署脚本第一行加
composer validate --strict，它会当场报错composer.lock是否与composer.json不匹配
最容易被忽略的一点：composer.lock 文件权限和换行符。Windows 编辑器保存后可能带 \r\n，Linux 下 install 会校验失败；Git 默认 core.autocrlf=true 会悄悄转换，建议项目根目录加 .gitattributes 锁定 composer.lock text eol=lf。
