最稳最快改全局镜像源的方式是运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，仅修改配置、不碰缓存、不编辑json、立即生效，且兼容1.x/2.x；url必须以/结尾，windows需重启终端，项目级配置优先级高于全局，验证需清缓存并检查实际请求域名。
怎么用一条命令改全局镜像源
直接运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就行。这是最稳、最快、副作用最小的方式——它只改配置，不碰缓存，不编辑 JSON 文件，改完立刻生效。
- 阿里云、腾讯云、华为云、中科大镜像都支持这个写法，把 URL 换掉就行
-
repo.packagist是 Composer 1.x 和 2.x 都兼容的键名；别写成repos.packagist（多一个 s）或mirror（官方根本不认） - URL 必须以
/结尾，比如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌——少个斜杠会导致路径拼错，404 报错 - Windows 用户改完别急着跑 install，先关掉再重开终端，否则可能读不到新配置
为什么改了还是走 packagist.org
不是命令没执行成功，大概率是被更高优先级的配置覆盖了——Composer 的镜像源有明确的“作用域优先级”：项目级 composer.json 中的 repositories > 全局配置 > 默认源。
- 进项目目录后执行
composer config --list，看有没有repositories相关输出；如果有，说明项目自己写了源，全局设置自动失效 - 检查项目根目录下的
composer.json，是否含"repositories": {...}字段；哪怕只有一行，也会完全屏蔽全局镜像 - CI/CD 环境里用了
sudo composer config -g，结果写进了 root 用户的~/.composer/config.json，但构建时用的是普通用户，根本读不到 - 执行
composer diagnose，看输出里Repo packagist.org:后面是不是你设的镜像地址；如果不是，就说明没生效
怎么验证镜像真的在用
别信“命令跑完了”，要亲眼看到请求发到了镜像域名上才算数。
- 清缓存：
composer clear-cache—— 否则可能还在用旧元数据，速度没变化 - 新建空目录，执行
composer init -n && composer require monolog/monolog --no-install，然后看日志里Downloading行是不是mirrors.aliyun.com这类域名 - 或者更直接：
composer show laravel/framework 11.* -vvv 2>&1 | grep "Downloading"，过滤出实际请求地址 - 如果看到
packagist.org或报Could not fetch https://mirrors.xxx/.../p2/，可能是 DNS 不通或镜像临时不可用，换一个试试
多个镜像怎么配才不白配
Composer 不会“智能选最快的”，它只按 repositories 数组顺序查，第一个返回 404 的才往下走；如果第一个超时或返回 500，就不会 fallback，直接报错。
- 想用阿里云 + 官方兜底，就得显式写全：
"repositories": [{"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}, {"packagist.org": false}]—— 注意，"packagist.org": false是禁用默认源，必须手动加回官方源才能兜底 - 私有包和公共包混用时，私有源一定要放
repositories最前面，否则名字一撞上（比如都叫utils/helper），Composer 就永远找不到你的私有版本 - 项目级配置会完全覆盖全局配置，不是叠加；所以如果项目里要加私有源，得把阿里云镜像也一起写进去，不能指望“全局的还在”
最容易被忽略的一点：改完配置后，composer install 可能仍走老源，不是因为命令错了，而是你正在一个已有 composer.lock 的项目里——它会复用 lock 文件里记录的源地址。删掉 composer.lock 再试一次，才是真实效果。
