执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可全局启用阿里云镜像，提升下载速度至1–5 MB/s并降低60%以上耗时，需验证是否生效且注意项目级配置覆盖风险。
直接执行这条命令就能全局生效
Composer 下载慢，90% 的情况不是你网不好，而是默认连的是海外 packagist.org，物理距离+TLS握手+CDN未缓存，卡在 10–30 KB/s 是常态。换阿里云镜像后，实测 composer install 耗时通常下降 60% 以上，稳定跑出 1–5 MB/s。
执行这一条命令即可：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
-
-g表示全局配置，写入~/.composer/config.json（macOS/Linux）或C:\Users\用户名\AppData\Roaming\Composer\config.json（Windows） -
repo.packagist是固定键名，不能写成repos.packagist或repository -
composer是type字段值，必须显式写出，不能省略 - 末尾斜杠
/必须保留，否则部分 Composer 版本会返回 404
验证是否真走镜像，别被假象骗了
很多人执行完命令就去 composer install，结果还是慢——因为镜像根本没生效。Composer 配置有优先级：项目级 > 当前用户级 > 全局级，只要 composer.json 里写了 "repositories"，就会覆盖全局设置。
用这两条命令交叉验证：
composer config -g repo.packagist
输出应为：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
再运行：
composer diagnose
重点看这一行：Repo packagist.org is default —— 如果出现，说明镜像没接管；如果显示 Repo https://mirrors.aliyun.com/composer/ is default，才算真正生效。
项目级配置要小心覆盖风险
团队协作或 CI 环境中，有时需要只改当前项目。进项目根目录，去掉 -g 执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这会在 composer.json 中插入 "repositories" 字段。但注意：
- 该命令会**完全替换**整个
"repositories"对象，不是合并——如果项目原本已有私有仓库配置，会被清空 - 如果项目已存在
composer.lock，首次composer install可能触发 hash 校验失败，此时需删掉vendor和composer.lock重装 - 公司内网若拦截
mirrors.aliyun.com，浏览器直连测试不通，换源也没用
换源后还慢？先查这几个硬性问题
镜像本身极少故障，但本地环境常埋雷：
-
SSL certificate problem: unable to get local issuer certificate：Windows 上 Composer 默认不带 CA 包，需在php.ini中设置curl.cainfo = "D:\path\to\cacert.pem" -
Could not resolve host: mirrors.aliyun.com：DNS 被公司策略屏蔽，可临时加 hosts（如118.31.67.52 mirrors.aliyun.com）或换腾讯云镜像试一试 -
composer update卡在Loading composer repositories with package information：加-vvv查看真实请求 URL，确认是否发到了镜像地址，而不是回退到了packagist.org
最常被忽略的一点：composer create-project 不支持 --repository 参数，想临时切镜像，必须先用 config -g 设好再执行。
