必须加--no-dev、--optimize-autoloader、--classmap-authoritative三个参数，缺一则导致类加载失败或性能骤降：--no-dev跳过dev包避免污染生产环境；--optimize-autoloader生成静态classmap提升加载速度50%以上；--classmap-authoritative强制仅查classmap，彻底禁用文件系统fallback。
直接裸写 composer install 在 Jenkins 流水线里，大概率导致线上类加载失败、性能骤降，甚至构建成功但服务启动报 Class not found。必须加三个参数，缺一不可。
为什么裸跑 composer install 会出事
CI 环境默认不启用 dev 依赖、不优化自动加载器、不强制类映射权威性——这和本地开发行为不一致，但线上环境恰恰最需要确定性。漏掉任一参数，vendor/autoload.php 就可能走文件系统扫描而非预生成映射，一旦 runtime 目录权限不对、PSR-4 命名空间没生效、或 autoloader 没 dump 干净，Class not found 就在所难免。
-
--no-dev：跳过require-dev里的包（如phpunit、infection），避免把测试工具打进生产镜像 -
--optimize-autoloader：生成vendor/composer/autoload_classmap.php，绕过实时文件扫描，类加载提速 50% 以上 -
--classmap-authoritative：配合前一个参数，让 Composer 完全信任 classmap，不再 fallback 到磁盘查找——这是防止运行时报错的最后一道防线
如何在 Jenkins Pipeline 中正确调用
不能只写一条命令就完事。Jenkins agent 是临时环境，composer.json 和 composer.lock 的状态必须可控，否则缓存和镜像配置都会失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 每次构建前先清理：
rm -rf vendor composer.lock，否则旧 lock 文件里的 dist URL 会绕过镜像设置 - 确保项目级镜像已写入：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g，且 URL 必须带结尾/） - 执行完整命令：
composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction - 如果项目定义了
post-install-cmd，需显式触发：composer run-script post-install-cmd --no-dev（CI 默认禁用钩子）
镜像配置为何总失效？怎么绕过
Jenkins agent 多数是 Docker 容器或临时节点，~/.composer/config.json 写进去就丢了；更关键的是，只要项目 composer.json 里有 "repositories" 字段，全局配置会被完全忽略——连 fallback 都不走。
- 别用
composer config -g，它在 Pipeline 里基本无效 - 不要手动编辑
composer.json的repositories数组来加镜像，容易覆盖私有源 - 正确做法：用脚本探测镜像可用性（比如
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json），返回非 200 就 fallback 到https://packagist.org，再执行composer config repo.packagist ... - 保留私有源时，应确保
"packagist.org": false是独立对象，镜像源排第一，私有源跟在后面
真正难的不是写对那条命令，而是每次构建都得重新校验镜像可用性、重写项目级配置、清空 lock 文件并确保 autoload 生效——这些步骤漏掉任意一环，CI 构建产物就和线上运行态不一致。
