composer config -g repo.packagist 不生效主因是键名错（必须单数）、缺type值“composer”、URL末尾无/，三者任一出错即静默回退官方源；验证需输出完整JSON或有效镜像URL，空/null或仍显示packagist.org即失败。
直接换镜像源能解决 90% 的 composer install 卡在 Downloading 的问题，但配置写错一个字符——比如少个斜杠、多一个 s、漏掉 composer 类型声明——就等于没配，Composer 会静默回退到 https://packagist.org，不报错也不提醒。
为什么 composer config -g repo.packagist 总是不生效？
这条命令失败时不会报错，但实际根本没走镜像。必须同时满足三个硬性条件：
-
repo.packagist是唯一合法键名（repos.packagist、mirror、packagist.org全部无效） - 中间那个
composer是type值，不是可选参数，漏掉就 fallback 到官方源 - URL 必须是 HTTPS + 末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼出/packages.json404）
验证是否真写进去了？只有一条命令可靠：composer config -g repo.packagist。输出必须是 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或纯 URL 字符串。空、null、或仍是 https://packagist.org，说明配置失败。
全局配置 vs 项目级配置：谁该用哪个？
全局配置省事，但在宝塔（www 用户）、CI（runner 用户）、Docker（www-data 或自定义用户）里大概率读不到——它们运行在非你当前用户的环境下。
立即学习“PHP免费学习笔记（深入）”；
- 个人开发或本地单机：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队协作或部署环境：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会自动安全追加到composer.json的repositories字段，不覆盖已有私有源 - 宝塔用户务必切到对应用户配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
手动编辑 composer.json 时，别写 "packagist": false——这个字段应放在根层级，否则 ext-json 等基础扩展校验会失败。
换源后仍卡在 Downloading 或报 hash 不匹配？
镜像只加速下载，但旧缓存和 composer.lock 里存的是原始源的元数据和哈希值。Composer 会优先读缓存并尝试从旧地址校验，结果就是卡在 DNS 或 TLS 握手，根本没发请求到镜像站。
- 删掉
vendor/和composer.lock - 再跑
composer install，让 Composer 重新从镜像拉取元数据并生成新 lock 文件 - 别试图保留旧
composer.lock——它和新镜像返回的元数据不兼容
如果 CI 脚本中不想污染环境，可用临时参数：composer install --repository=https://mirrors.aliyun.com/composer/（注意是 --repository，不是 --repository-url，后者会被静默忽略）。
换源后还卡在 Resolving dependencies？和镜像无关
镜像只加速元数据加载和 ZIP 包下载，不参与依赖解析。卡在这里基本是 composer.json 或环境问题：
- PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0"，让 Composer 尝试遍历大量不兼容版本 -
require-dev里塞了太多工具链（如phpunit、phpstan），大幅增加解空间 - 用了已废弃的
fxp/composer-asset-plugin（常见于老版 Yii2），它绕过 Composer 镜像机制，直连 Bower/NPM 源 - Xdebug 启用中会让解析慢 5–10 倍，可临时禁用：
php -d xdebug.mode=off $(which composer) install
这些情况换任何镜像都无效，得收紧约束、拆分 dev 包、或升级到原生 asset 管理方案。
