composer镜像切换必须严格满足三要素：键名repo.packagist（单数小写）、type值显式为composer、url以https://开头且末尾带/，任一缺失均静默回退官方源且不报错；验证需输出完整json、diagnose显示镜像地址、-vvv日志含镜像域名。
换镜像不是“试试看”，而是必须严格按三要素执行：键名 repo.packagist（单数、小写、无 s）、type 值显式写 composer、URL 必须以 https:// 开头且末尾带 /。漏掉任意一个，composer install 仍走官方源，且完全不报错。
为什么 composer config -g repo.packagist 总不生效？
这不是网络慢，是命令写错了——Composer 2.x 内部硬编码只识别 repo.packagist 这个 exact key。常见错误包括：
-
repos.packagist（多了一个s）→ 存进无效字段，composer config -g repo.packagist输出为空或null - 漏掉
-g→ 只改当前项目composer.json，换目录就失效 - URL 少了末尾
/→ 请求路径拼成/composerpackages.json，直接 404 - 漏写
composer类型值 → fallback 到https://packagist.org，等于白配
一行命令切阿里云 / 腾讯云 / 华为云镜像
不同镜像路径格式差异明显，不能套用模板。直接复制粘贴执行（注意空格和斜杠）：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/ - 中科大（USTC）：
composer config -g repo.packagist composer https://packagist.mirrors.ustc.edu.cn/
清华旧镜像 https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host。
验证是否真在用镜像？别信“好像快了”
必须交叉验证三项：
- 查配置：
composer config -g repo.packagist输出必须是完整 JSON，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 看诊断：
composer diagnose中 “Repo” 行应显示镜像地址；若仍是https://packagist.org，说明被项目级repositories覆盖了 - 盯日志：删掉
vendor和composer.lock，跑composer install -vvv，日志里下载 URL 必须含mirrors.aliyun.com等镜像域名
composer.lock 文件里的 dist URL 是旧的，哪怕镜像已生效，composer install 仍会先尝试原始地址——必须清缓存 + 重生成 lock 才能彻底切换。
