最稳方式是执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，需严格核对三要素：repo.packagist（不可多s或漏repo.）、composer类型不可省、URL必须HTTPS且结尾带斜杠。
直接换阿里云镜像最稳，composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 一行命令搞定，但写错任何一个字符都会静默失效。
全局配置命令必须写对三个关键点
很多人执行完命令没效果，不是网络问题，是命令本身错了。重点检查：
-
repo.packagist不能写成repos.packagist（多一个 s）、也不能漏掉repo.前缀变成packagist - 中间的
composer是 type 值，不能省——它不是可选参数，而是必须声明的源类型 - URL 必须用 HTTPS，且末尾必须带斜杠：
https://mirrors.aliyun.com/composer/，少斜杠会 404 - 一定要加
-g，否则只改当前目录下的composer.json，换个项目就回退
验证是否生效：运行 composer config -g repo.packagist，输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的 JSON 对象。空、null 或报错说明没写进去。
项目级配置更适合团队和 CI 环境
全局配置看似省事，但在协作或自动化场景下反而容易出问题：比如开源项目要求走官方源做 hash 校验，或 CI 流水线里混用不同镜像导致依赖解析不一致。
- 进项目目录，执行不带
-g的命令：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 该命令会自动在
composer.json顶层写入"repositories"字段，key 必须是"packagist"，不能自定义成"aliyun"等别名 - 如果项目已有
"repositories"，别手动编辑覆盖——用命令追加，否则可能误删私有包源 - 换源后首次
composer install若报 hash 校验失败，删掉vendor和composer.lock重来即可
临时切换镜像只对 install/update 生效
不想动配置、只想测某个镜像是否可用，或者 CI 脚本里需要隔离环境，就用 --repository-url 参数：
- 有效命令示例：
composer install --repository-url=https://mirrors.aliyun.com/composer/ - 它优先级最高，会覆盖全局和项目级配置
-
composer require后面加这个参数不生效——只有install和update支持 - packagist.phpcomposer.com 已停用，现在能稳定用的只剩阿里云、腾讯云、华为云三家；用错地址会卡在
Loading composer repositories几十秒，最后报Could not fetch https://xxx/packages.json
镜像只解决下载慢，不解决 Resolving dependencies 卡顿。如果 composer update 卡在这一步，大概率是 composer.json 里 PHP 版本约束太宽、dev 包没锁版本，或者 require-dev 塞了太多工具链——跟镜像源无关。
