换镜像只加速下载，大型项目install/update慢主因是Resolving dependencies或Generating autoload files阶段的本地瓶颈：PHP内存不足、Xdebug启用、platform不匹配、宽泛版本约束、classmap-authoritative强制全量扫描vendor等，均与网络无关。
为什么换镜像后大型项目 install/update 还是慢
换源只加速下载阶段，但大型项目卡顿往往发生在 Resolving dependencies 或 Generating autoload files 阶段——这两个环节根本不走网络，和镜像无关。常见真实瓶颈包括：
• PHP 内存不足（Composer 默认限制 128M，解析数百包时直接 OOM）
• classmap-authoritative 模式开启（Composer 3.x 默认启用，每次 update 强制全量扫描 vendor 目录）
• Xdebug 启用中（会让依赖解析慢 5–10 倍）
• platform 配置与实际 PHP 版本不匹配（如声明 "php": "7.4" 却在 PHP 8.5.5 上运行，触发降级回溯）
• composer.json 中存在宽泛约束（如 "monolog/monolog": "^1.0 || ^2.0"），导致 SAT 求解器暴力穷举
如何验证 packages.json 是否真从国内镜像拉取
光看 composer config -g repo.packagist 输出没用，必须确认实际请求打到了镜像域名。执行：composer install -vvv 2>&1 | grep "Reading packages.json"
如果输出里出现 mirrors.aliyun.com 或 mirrors.huaweicloud.com，说明生效；若仍是 packagist.org 或 repo.packagist.org，说明配置被覆盖或拼写错误。
常见失效原因：
• 键名写成 repos.packagist（多一个 s）——新版 Composer 2.2+ 静默忽略
• URL 少了末尾斜杠：https://mirrors.aliyun.com/composer ❌ → https://mirrors.aliyun.com/composer/ ✅
• 项目级 composer.json 里有 "repositories": {}（空对象也会屏蔽全局配置）
parallel-downloads 开启后仍无提速效果
并发下载只对 composer install 生效，composer update 仍需串行解析依赖图，这是设计使然。真正要开并发，必须：
• 全局设置： composer config -g parallel-downloads 8（设为 10 容易触发临时文件竞争）
• 确认 Composer ≥ 2.2（旧版不支持）
• 避免项目级 repositories 覆盖（它会禁用并行逻辑）
• 不要同时开 --no-cache 和高并发——缓存缺失会导致元数据反复重拉，反而拖慢整体速度
• 若用华为云镜像，URL 必须是 https://mirrors.huaweicloud.com/repository/php/composer/，少任何一段路径都会 404
vendor 已存在但 update 巨慢，本质是本地 I/O 不是网络问题
Composer 3.x 默认开启 classmap-authoritative，每次 update 都强制重扫整个 vendor 目录生成 classmap。这不是镜像能解决的，必须关掉：composer config -g classmap-authoritative false
或者在项目级临时禁用：composer update --no-autoloader && composer dump-autoload
另外两个关键动作：
• 关 Xdebug：php -d xdebug.mode=off $(which composer) update
• 加内存限制：COMPOSER_MEMORY_LIMIT=-1 composer update
别指望镜像解决这些——它们发生在你的机器上，和 packagist 或阿里云都没关系。
立即学习“PHP免费学习笔记（深入）”；
