验证镜像是否真生效需查三处：运行composer config -g repo.packagist输出必须为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；composer diagnose中“repo”行须显示该镜像地址；composer install -vvv日志中出现downloading https://mirrors.aliyun.com/...才算真正生效。
Composer 下载慢，90% 不是网络问题，而是镜像没生效、Xdebug 没关、缓存没清，或者根本卡在非下载阶段（比如 Resolving dependencies）。先确认是不是真在走镜像，再查本地环境，最后才动网络参数。
怎么验证镜像是否真生效了？
别信“我执行过命令”，得看三处输出：
- 运行
composer config -g repo.packagist，必须输出类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}—— 空、null、或仍是https://packagist.org都说明没生效 - 执行
composer diagnose，看 “Repo” 行是否显示你的镜像地址；如果还是packagist.org，大概率被项目级repositories覆盖了 - 删掉
vendor/和composer.lock，再跑composer install -vvv，滚动日志里出现的Downloading https://mirrors.aliyun.com/...才算真正走镜像
常见静默失败原因：repo.packagist 写成 repos.packagist（多一个 s）、漏掉 -g、URL 少末尾 /、或没写 composer 这个 type 值。
为什么换了镜像还卡在 Resolving dependencies？
这个阶段不发网络请求，纯本地 CPU + 内存运算。慢 ≠ 镜像问题，而是依赖求解器卡住了：
-
COMPOSER_MEMORY_LIMIT=-1临时加内存：默认 128M 在复杂项目里经常不够，OOM 后会反复重试 - 检查
php -v输出是否含xdebug—— 启用状态下会让求解慢 5–10 倍，用php -d xdebug.mode=off $(which composer) install临时禁用 - 对比
composer.json里的"platform": {"php": "..."}和当前 PHP 版本（php -v），不匹配会触发降级查找逻辑，遍历大量旧版本 -
composer.lock里可能残留已下线包的 dist URL，删干净再重装
并发下载和超时参数怎么设才不翻车？
Composer 2.2+ 已弃用 parallel-downloads，它不会报错但完全无效。只认 http-max-concurrent-downloads：
- 设值推荐 8～10：
composer config -g http-max-concurrent-downloads 10，超过 12 容易触发本地文件句柄竞争或镜像限流 - 必须同步加大超时：
composer config -g http.timeout 300和composer config -g process-timeout 3600 -
--prefer-dist是生产环境必加项，避免 git clone；但它不跳过 autoload 生成，所以首次安装仍需时间
注意：这些参数对 composer update 几乎没用，只加速 install 阶段的 ZIP 下载。
镜像源选哪个？怎么测真实延迟？
别盲目换源，先用 curl 测首字节延迟（不是总耗时）：
- 执行三次：
curl -o /dev/null -s -w "%{time_starttransfer}\n" https://mirrors.aliyun.com/composer/packages.json - 取中位数，超过 1.5 秒的镜像别用 —— 即使配置对了，链路本身不稳定也白搭
- 清华源支持 HTTP/2：
curl -I --http2 https://mirrors.tuna.tsinghua.edu.cn/composer/返回HTTP/2 200才算真支持 - 阿里云目前仍是 HTTP/1.1，高并发时容易排队；腾讯云华南节点更稳；华为云不托管 dist 包，只代理 metadata，适合教育网用户
当前（2026 年 7 月）实测稳定可用的三个源：https://mirrors.aliyun.com/composer/、https://mirrors.cloud.tencent.com/composer/、https://repo.huaweicloud.com/composer/。别碰已停服的 packagist.phpcomposer.com 或 laravel-china.org。
