执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 可全局切换至阿里云镜像，但必须严格满足三要素：-g（全局）、repo.packagist（单数键名）、composer（type值），缺一或拼写错误均静默失效；Windows下配置文件位于%APPDATA%\Composer\config.json；项目级repositories字段会覆盖全局配置，可用composer config --unset repositories移除或--repository-url临时指定；最终须通过composer update -vvv查看下载URL验证真实生效。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局切到阿里云镜像，但这条命令必须三个要素全对——-g、repo.packagist（单数，不能多 s）、composer 类型标识，缺一不可，否则静默失效。
为什么 composer config -g repos.packagist 没反应
因为 Composer 内部只认 repo.packagist（单数 repo），写成 repos.packagist 会把配置存进一个无效字段，composer config -g repo.packagist 查出来是空或 null，install 还是连 packagist.org。Windows 下用 Git Bash 时还要注意：实际读的是 %APPDATA%\Composer\config.json，不是 ~/.composer/config.json，改完建议直接打开这个文件看内容是否已更新。
composer config 命令里那三个参数都不能省
这条命令本质是写入 JSON 配置，每个位置都有语义：
-
-g：表示写入全局配置，漏掉就只改当前项目下的composer.json，换目录就失效 -
repo.packagist：键名，大小写敏感，不能拼成repositories.packagist.org（那是新版推荐写法，但 2.2+ 才真正生效，旧版直接忽略） -
composer：这是type值，不是注释，也不是可选项；省略它，Composer 2.0+ 会 fallback 到默认源，等于白配 -
https://mirrors.aliyun.com/composer/：URL 必须以https://开头、结尾带/，少一个斜杠会拼出/composerpackages.json导致 404
项目级配置覆盖了全局设置怎么办
只要项目根目录的 composer.json 里有 "repositories" 字段（哪怕只是 {} 或 []），全局配置就完全失效。常见于 Laravel 脚手架、私有模板或 CI 流水线预置的 composer.json。
- 临时验证是否被覆盖：运行
composer config -g repo.packagist有输出，但composer diagnose的 “Repo:” 行仍显示packagist.org，基本就是项目级配置在起作用 - 安全绕过方式：进项目目录，运行
composer config --unset repositories，它会删掉整个repositories字段（不是清空，是移除），之后全局镜像就能生效 - 不想动项目配置？加
--repository-url强制指定，比如composer install --repository-url=https://mirrors.aliyun.com/composer/
最易被忽略的一点：改完不验证真实请求路径。别只信 composer config -g 的输出，一定要跑一次 composer update -vvv，看日志里 Downloading 的 URL 是不是含 mirrors.aliyun.com —— 这才是真生效。
