中文镜像只加速下载，不加速依赖解析；卡在“resolving dependencies”时换镜像完全无效，因其本质是本地sat求解器穷举版本组合，不发网络请求，镜像仅作用于后续下载阶段。
中文镜像只加速下载，不加速依赖解析；卡在 “Resolving dependencies” 时换镜像完全无效。
为什么镜像对 install 的提速有上限
Composer install 分两个阶段：先本地穷举满足 composer.json 约束的版本组合（Resolving dependencies），再按 composer.lock 下载对应资源（Installing dependencies）。镜像仅作用于第二阶段——它不能让求解器更快算出哪个版本组合合法，也不能跳过 PHP 版本校验、platform 配置比对、xdebug 拖慢等本地计算开销。
常见误判场景：
- 执行
composer install卡在 “Resolving dependencies” 超过 30 秒 → 实际是 CPU 在跑约束求解，和镜像无关 - 镜像 URL 末尾缺斜杠（如
https://mirrors.aliyun.com/composer）→ 返回 404，Composer 自动 fallback 到 packagist.org，你以为换了，其实没走镜像 - 项目级
repositories字段存在且指向已下线私有源 → Composer 逐个超时才退到镜像，整体耗时反而更长
镜像真正起效的三个前提
即使配置了阿里云或腾讯云镜像，也必须同时满足以下三点，下载阶段才能真正变快：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer config -g repo.packagist输出是完整 JSON，含{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，不是空、null或字符串 URL - 项目中未定义
repositories字段，或已确认该字段未覆盖全局配置（可用-vvv日志看实际请求域名） - 使用了
--prefer-dist参数，且包在镜像中存在 dist ZIP（国内镜像基本不缓存 source，--prefer-dist失效时会降级为慢速 git clone）
parallel-downloads 和 http-max-concurrent-downloads 到底该用哪个
Composer 2.2+ 已废弃 parallel-downloads，改用 http-max-concurrent-downloads。设错参数等于白配：
- 旧命令
composer config -g parallel-downloads 10在 2.2+ 中静默忽略，必须改用composer config -g http-max-concurrent-downloads 10 - 并发数不是越高越好：设为 15 可能触发临时文件竞争，报
file_put_contents(/tmp/): failed to open stream，建议从 6–10 开始试 - 并发只对 download 阶段有效，且严重依赖镜像是否支持 HTTP/2；若镜像未生效，它连并发机会都没有
镜像 + 参数组合才是完整提速链路
单独换镜像最多提升 30–50% 下载耗时，但整条 install 流程要压到秒级，必须搭配关键参数：
-
--no-dev：跳过require-dev，省掉 PHPUnit、phpstan 等大体积包的下载与解压 -
--prefer-dist：强制走 ZIP，避免 git clone 的 I/O 和 submodule 同步开销 -
--optimize-autoloader（或-o）：生成 classmap，减少运行时文件扫描 -
--classmap-authoritative（或-a）：部署专用，告诉 autoloader “不在映射里=真没有”，彻底跳过file_exists()调用
CI/CD 中推荐固定组合：composer install --no-interaction --no-progress --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative。注意：--classmap-authoritative 在本地开发禁用，否则新增类直接 Class not found。
