默认直连packagist.org是生产部署慢的主因，非网络差而是DNS/TLS/CDN多层失败致重试；换镜像仅加速下载与元数据获取，不解决Resolving dependencies卡顿，该阶段由SAT求解器本地穷举版本组合引发，典型诱因包括PHP版本约束过宽、minimum-stability设为dev、composer.lock缺失、私有源下线及镜像配置错误（键名repo.packagist、type=composer、URL末尾缺/）。
默认直连 packagist.org 是生产部署慢的主因，不是网络差，而是 DNS/TLS/CDN 多层失败导致反复重试；配对中文镜像后，composer install 通常从 3–5 分钟压到 20–40 秒内，但前提是配置正确且参数匹配。
为什么改了镜像地址还是卡在 Resolving dependencies？
镜像只加速包下载和元数据获取，不参与依赖解析。这个阶段卡住，和镜像无关，典型诱因有：
-
composer.json中写了过宽的 PHP 版本约束，比如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"，让 SAT 求解器穷举组合 - 存在
"minimum-stability": "dev"，强制拉取大量不稳定分支 -
composer.lock被删或未提交，install实际退化为update - 项目
repositories里写了已下线的私有源，Composer 逐个超时才 fallback
必须写对 repo.packagist，否则镜像完全不生效
90% 的“换源无效”问题出在键名、类型、URL 格式三处硬性要求上：
- 键名必须是
repo.packagist（不是repos.packagist，多一个 s 就静默失效） - type 值必须显式写
composer，命令中不能省略 - URL 必须以
/结尾，例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/p2//类路径直接 404 - 验证方式：运行
composer config -g repo.packagist，输出必须是完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
部署脚本里不加这几个参数，镜像提速效果打五折
光换镜像只是第一步，CI/CD 环境必须叠加以下参数才能释放全部性能：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--no-interaction：避免因无 TTY 卡在交互提示 -
--prefer-dist：强制走 ZIP 包，跳过耗时的git clone -
--no-dev：跳过require-dev，省掉 30–60% 时间 -
--optimize-autoloader和--classmap-authoritative：生成类映射并关闭文件扫描，PHP 运行时更快，且不影响部署耗时
推荐 CI 部署命令： composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress
私有包和镜像能共存吗？
能，而且无需额外操作——镜像配置只影响 packagist.org 官方源，对 repositories 中定义的 VCS、path、Satis 等私有源完全透明。
但要注意：composer.json 顶层的 "packagist.org": false 会禁用所有官方包，必须删掉或设为 true；如果已有私有源，别用 composer config repo.packagist 全量覆盖 repositories，应手动编辑或让 Composer 自动追加。
