Composer全局镜像配置不生效，主因是命令格式错误（如大小写、复数、缺/composer/末尾斜杠）、项目级repositories字段覆盖全局设置，或未执行clear-cache清缓存。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但 90% 的失败不是网络问题，而是命令写错一个字符就静默回退官方源——不报错、不提示、只卡住。
为什么 composer config -g repo.packagist 总不生效
Composer 2.2+ 对这个配置项极其敏感，错一点就完全忽略：
-
repo.packagist必须是单数、全小写、无额外字符；写成repos.packagist或packagist.org会存进无效字段，查composer config -g repo.packagist输出为空或null - 中间的
composer是 type 值，不是注释——漏掉它，Composer 就 fallback 到https://packagist.org - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼出/composerpackages.json导致 404） - 没加
-g→ 只改当前项目composer.json，换目录就失效
项目级 repositories 覆盖全局配置怎么办
只要项目根目录的 composer.json 里有 "repositories" 字段，无论内容是空对象、{"packagist.org": false} 还是硬编码了官方源，全局 repo.packagist 都完全不生效。
- 验证方法：运行
composer diagnose，看 “Repo:” 行是否显示阿里云地址；若仍是https://packagist.org，基本就是被覆盖了 - 安全移除方式：进项目目录，执行
composer config --unset repositories（注意没-g） - 不想删？用
grep -A3 '"repositories"' composer.json检查内容，手动删掉整个字段更稳妥 - 删完务必补一句
composer clear-cache，否则旧缓存仍可能拉错源
执行后必须做的两件事：清缓存 + 验证真实 URL
换源后不清理缓存，Composer 仍会用旧的元数据（比如包列表、版本映射），导致实际还是连官方源。
- 立即执行：
composer clear-cache - 验证是否真写进去了：
composer config -g repo.packagist.url，输出应为https://mirrors.aliyun.com/composer/ - 最终确认走哪个源：
composer diagnose，重点看 “Repo:” 后面的地址；再跑一次composer update -vvv，观察下载请求的 URL 是否含aliyun.com/composer - Windows 用户注意路径权限：若提示
Permission denied，可能是杀毒软件锁了%APPDATA%\Composer\config.json，试试管理员权限终端
最易被忽略的是：项目里那个看似无害的空 "repositories": {}，它足以让全局配置彻底失效；而 composer clear-cache 不是可选项，是必做动作——缓存不清理，镜像就等于没切。
