命令不生效是因为漏了关键三要素：未加-g、键名错写为repos.packagist（多s）、url末尾缺/，任一出错均静默回退至官方源，且不报错。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，是命令漏了关键三要素中的任意一个：没加 -g、键名写成 repos.packagist（多了一个 s）、URL 末尾缺 /。这三处任一出错，Composer 都静默 fallback 到 https://packagist.org，且完全不报错。
Composer 2.x 硬编码只识别 repo.packagist（单数、全小写、无 s），composer 是必须显式传入的 type 值，不是注释；漏掉它，配置就无效。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ 正确 -
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/❌ 键名错，存进无效字段 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌ 缺composer类型值，回退官方源 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer❌ 少末尾/，请求路径拼成/composerpackages.json导致 404
切阿里云 / 腾讯云 / 华为云镜像的一行命令
不同镜像地址格式差异明显，尤其华为云路径含 /repository/php/，不能直接套用阿里云模板。复制时注意空格和斜杠：
- 阿里云：
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/ - 中科大：
composer config -g repo.packagist composer https://packagist.mirrors.ustc.edu.cn/
清华旧镜像 https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host 或 cURL error 60。
验证镜像是否真在用，别信“好像快了”
执行完命令后必须验证，否则可能白配：
- 运行
composer config -g repo.packagist，输出必须是类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}的 JSON 对象；空、null或报错说明没写进去 - 运行
composer diagnose，看 “Repo” 行是否显示你的镜像地址；若仍是https://packagist.org，说明被项目级repositories字段覆盖了 - 删掉
vendor和composer.lock，再跑composer install -vvv，观察日志里下载 URL 是否含mirrors.aliyun.com（或你选的镜像域名）
项目根目录下若有 composer.json 里硬写了 "repositories" 字段，它优先级高于全局配置——这是最容易被忽略的干扰项。
项目级配置更适合 CI 和团队协作
全局配置在宝塔面板、GitHub Actions、Docker 容器等场景下容易失效，因为它们默认不读当前用户家目录的 ~/.composer/config.json，或运行用户与配置归属用户不一致（比如用 sudo 配了 root 的配置，但 CI 以 www 用户运行）。
更稳妥的做法是进项目根目录，去掉 -g 执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
它会安全地向 composer.json 的 repositories 字段合并结构，不破坏已有私有源（前提是原 repositories 是对象，不是数组）；该配置可 Git 跟踪，新人拉代码后行为一致。
注意：composer.lock 文件里记录的 dist URL 仍指向原始源——哪怕镜像已生效，composer install 仍会先尝试旧地址。必须清缓存：composer clear-cache，并确保 composer.lock 重建后才真正走镜像。
