直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可全局生效，但漏 -g、键名错为 repos.packagist、URL 末尾缺 / 或漏掉 composer type 值，四者任一出错均静默回退官方源；验证需 composer config -g repo.packagist 输出完整 JSON 对象。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局生效，但漏 -g、键名写成 repos.packagist、URL 缺末尾 / 或漏掉 composer 类型值，四者任一出错都会静默走官方源——不是慢，是根本没切过去。
为什么 composer config -g repo.packagist 总不生效？
Composer 2.x 硬编码只认 repo.packagist（单数、全小写、无 s），写成 repos.packagist 或 packagist.org 会存进无效字段，命令不报错，但查 composer config -g repo.packagist 输出为空或 null，install 仍卡在 Loading composer repositories...。
-
-g必须带上：漏了就只改当前项目composer.json，换目录立即失效 -
repo.packagist是固定键名：大小写、复数、前缀缺一不可 -
composer是必需的type值：不是注释，省略就 fallback 到https://packagist.org - URL 必须以
https://开头且末尾带/：少斜杠会拼成/composerpackages.json，直接 404
一行命令切阿里云 / 腾讯云 / 华为云镜像
不同镜像路径格式差异明显，不能套用模板。华为云含 /repository/php/，中科大（USTC）同步略慢，清华旧镜像 https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host。
- 阿里云：
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/
验证是否真在用镜像？别信“好像快了”
仅靠安装速度判断容易误判。必须交叉验证三处：
- 查配置：
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或对应镜像域名
项目级配置比全局更可靠？关键看场景
全局配置适合本地开发，但在 CI、宝塔面板、多用户环境里极易权限错位（比如 www 用户执行命令却写了 root 的全局配置）。项目级配置可 Git 跟踪，新人拉代码后行为一致。
- 进项目根目录，执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 它会安全合并到
composer.json的"repositories"字段中，前提是原字段为对象（如"repositories": { "packagist": {} }），不是数组 - 已有
"repositories": []或"repositories": { "packagist.org": false }时，需先手动清理再执行，否则旧缓存可能仍触发官方源请求
最常被忽略的是 composer.lock 里记录的 dist URL 仍指向原始源——哪怕镜像已生效，install 仍会先尝试旧地址。必须清缓存：composer clear-cache，必要时重生成 lock 文件。
