执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可成功切换镜像，但90%失败源于三类低级错误：漏 -g、键名误写为 repos.packagist（多s）、URL末尾缺 /；任一出错均静默回退至官方源且不报错。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能切成功，但 90% 的失败不是网络问题，是命令漏了 -g、键名写成 repos.packagist（多一个 s）、或 URL 少了末尾 /——三者任一出错，Composer 都静默 fallback 到 https://packagist.org，且完全不报错。
为什么 composer config -g repo.packagist 总没反应
这不是命令没运行，而是 Composer 对配置项识别极严格，写错一点就完全忽略：
-
repo.packagist必须是单数、全小写、无s；写成repos.packagist或packagist.org会存进无效字段，composer config -g repo.packagist输出为空或null就是典型表现 - 中间必须显式传
composer—— 这是type值，不是注释；漏掉它，配置无效，自动回退官方源 - URL 必须以
https://开头且末尾带/；少斜杠会导致路径拼成/composerpackages.json，直接 404 - 没加
-g→ 只改当前项目composer.json，换目录就失效
不同镜像的 URL 格式差异很大，复制时不能只换域名
华为云、中科大、阿里云等地址结构不一致，硬套模板必出错：
- 阿里云：
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/（注意/repository/php/这一段不能省） - 中科大：
composer config -g repo.packagist composer https://packagist.mirrors.ustc.edu.cn/ - 清华旧镜像
https://packagist.phpcomposer.com已下线，继续用会报Could not resolve host或cURL error 60
切完镜像，composer install 还是慢？关键在 composer.lock 和缓存
镜像配置成功 ≠ 下载立刻走国内节点。因为 composer.lock 里记录的是原始 dist.url（比如 https://packagist.org/dists/），Composer 会优先尝试这个地址，失败后才 fallback（且 fallback 不保证成功）：
- 必须先运行
composer clear-cache，否则元数据仍指向旧源 - 再运行
composer update --lock，强制重写composer.lock中所有包的dist.url字段，使其指向镜像路径（如https://mirrors.aliyun.com/composer/dists/） - 删掉
vendor/和composer.lock后重新composer install -vvv，日志中下载 URL 应含镜像域名，这才是真实生效证据
验证是否真在用镜像，别信“好像快了”
只看安装速度或 composer config -g repo.packagist 输出 JSON 不够，必须交叉验证三处：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 运行
composer diagnose，检查 “Repo” 行是否显示你的镜像地址；若仍是https://packagist.org，说明被项目级repositories覆盖 - 执行
composer require monolog/monolog -vvv 2>&1 | grep "GET.*packages.json"，URL 应为镜像地址，不是repo.packagist.org
最易被忽略的是：项目级 composer.json 中的 repositories 字段会直接覆盖全局配置，哪怕你已经正确设置了 repo.packagist；清缓存也救不了它——得手动删掉或设 "packagist.org": false 才行。
