composer config -g repo.packagist 命令失效主因是键名错（必须单数repo）、缺type值“composer”、URL末尾无/，三者任一出错即静默回退官方源；验证需输出完整JSON对象。
直接换镜像源能立竿见影，但90%的人配完还是慢——不是镜像不行，是命令写错、缓存没清、或根本没走对源。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但静默回退到 https://packagist.org，你还在等下载完成。必须同时满足三个硬性条件：
-
repo.packagist必须是单数、小写、不能多一个s（repos.packagist无效） - 中间那个
composer是 type 值，不是可选参数，漏掉就当没这回事 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
验证是否成功，只看这一条命令输出：composer config -g repo.packagist。结果必须是 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串。空、null、或仍是 https://packagist.org，说明根本没写进去。
换镜像后 composer install 还卡在 downloading
镜像只加速下载，但旧缓存和 lock 文件会拖后腿：
立即学习“PHP免费学习笔记（深入）”；
-
composer clear-cache清掉本地元数据缓存（含旧源地址） - 删掉
vendor/和composer.lock——composer.lock里锁的是原始 dist URL，不删它，Composer 仍会尝试从 packagist.org 下载 - 重跑
composer install --no-cache，强制跳过缓存，确保请求发向新镜像
如果日志里出现大量 GET https://mirrors.aliyun.com/composer/ 或 Downloading xxx.zip，说明镜像已生效；若仍卡在 Resolving dependencies，那和镜像无关，是 PHP 内存不足、xdebug 开着、或版本约束太宽（比如 "*"）导致求解器卡死。
CI/CD 或宝塔环境里镜像为啥不生效
全局配置写在 ~/.composer/config.json，但 CI 流水线用 runner 用户、宝塔用 www 用户，它们读不到你本地 root 或个人账户下的配置：
- 宝塔用户要切到对应用户执行：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - GitHub Actions / GitLab CI 中，别依赖全局配置，改用临时参数：
composer install --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/ --no-dev --optimize-autoloader -
--repository-url优先级最高，100% 走指定源，且不污染composer.json
注意：--repository（少 -url）已废弃，Composer 2.9.6+ 会直接报错。
项目级配置比全局更可靠，但要注意 repositories 结构
进项目根目录后运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会自动往 composer.json 的 repositories 字段里追加，但前提是该字段存在且格式合法：
- 如果原本是
"repositories": {}，命令会转为数组并插入packagist条目 - 如果原本是
"repositories": [ { "type": "vcs", "url": "..." } ]，它会在数组末尾追加，不破坏私有源 - 千万别手动写
"packagist": false——会导致ext-json等基础扩展校验失败
改完后建议立刻跑一次 composer update --lock，让 composer.lock 记录新源的包哈希和元数据，否则协作时别人拉代码仍可能走错源。
最常被忽略的一点：镜像只管下载，不管依赖解析。一旦 composer.json 里写了 "php": "*" 或 "minimum-stability": "dev"，再快的镜像也救不了卡在 Resolving dependencies 的命运。
