composer config -g repo.packagist 命令不生效是因为三个硬性条件缺一不可：键名必须严格为repo.packagist（非repos等变体）、中间composertype值不可省略、url须https且末尾带/；任一不符即静默回退至packagist.org。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但 composer install 依然连 packagist.org——根本不是网络问题，而是三个硬性条件缺一不可：
-
repo.packagist键名必须一字不差（repos.packagist、repository.packagist全无效） - 中间的
composer是type值，不是可选参数，也不能省略或替换成其他字符串 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json导致 404）
验证是否写入成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报 Key not found，说明没写进去。
项目级配置比全局更可靠
你在终端配好了全局镜像，但 GitHub Actions、宝塔后台、同事电脑上照样失效——因为它们读的是各自用户的 ~/.composer/config.json，跟你不是同一个文件。
真正协作友好的做法是进项目根目录（含 composer.json），运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动在 composer.json 的 repositories 字段里安全追加一条 "packagist" 记录，不覆盖已有私有源。改完必须删掉 vendor/ 和 composer.lock，再执行 composer install（不是 update），否则旧 lock 文件仍指向海外地址。
换源后还卡在 “Loading composer repositories” 怎么办
镜像只加速下载环节，但卡点常藏在缓存和旧元数据里：
- 先运行
composer clear-cache - 手动删掉项目下的
vendor/和composer.lock - 用
composer install -vvv观察日志，确认请求发往mirrors.aliyun.com而非packagist.org - 如果仍出现
packagist.org，检查composer.json是否存在"repositories"字段（哪怕只写了{}或{"packagist.org": false}），它会直接屏蔽全局配置
新版 Composer 推荐用 repos.packagist.org
Composer 2.2+ 官方推荐更规范的键名 repos.packagist.org 替代旧的 repo.packagist，尤其在需要精确覆盖子域名请求时 fallback 更稳定。
对应命令是：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'
注意：第二个参数必须是完整 JSON 字符串，不能只传 URL，否则报 Invalid repository type。旧命令仍兼容，但在处理带自定义 metadata 的包时可能 fallback 失败。
最易被忽略的一点：无论用哪种方式配镜像，只要项目 composer.json 里存在 repositories 字段，全局配置就完全失效——Composer 的优先级是硬编码的，没有商量余地。
