全局配置阿里云镜像后仍走官方源，主要是因Composer版本过低（2.0以下）或被项目级repositories覆盖；Composer按项目→用户→全局优先级合并配置，项目中显式声明packagist.org会跳过镜像。
为什么全局配置阿里云镜像后仍走官方源？
常见原因是 Composer 版本过低（2.0 以下）或配置被项目级 composer.json 中的 repositories 覆盖。Composer 会按「项目配置 → 当前用户配置 → 全局配置」优先级合并，项目里显式写了 "packagist.org" 就会跳过镜像。
- 检查当前生效配置：
composer config -g repos.packagist，应返回类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 若返回空或仍是
https://packagist.org，说明全局未生效，需重新设置 - 运行
composer diagnose，关注输出中Repo packagist.org is default这一行——如果出现，代表镜像未接管
用 composer config 设置阿里云或腾讯云镜像
推荐使用命令行直接写入全局配置，避免手动编辑 ~/.composer/config.json 出错。两个主流镜像地址和对应命令如下：
- 阿里云镜像（稳定、同步及时）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云镜像（部分地区延迟更低）：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
注意：repo.packagist 是固定键名，不是变量；composer 是 type 字段值，不能省略；末尾斜杠 / 必须保留，否则部分版本会报 404。
临时切换镜像：不改配置也能加速 install/update
某些 CI 环境或临时调试时，不想污染全局配置，可用 -r 参数指定仓库：
composer install -r https://mirrors.aliyun.com/composer/
该方式只对当次命令生效，且会完全忽略所有已配置的仓库（包括项目级），适合排查网络问题或验证镜像可用性。但注意：composer create-project 不支持 -r，此时需先用 config -g 临时设好再执行。
镜像失效或 400 错误的典型原因
阿里云/腾讯云镜像本身极少宕机，但实际使用中常因 HTTPS 证书、DNS 或代理策略出问题：
-
SSL certificate problem: unable to get local issuer certificate：Windows 上 Composer 默认不带 CA 证书包，需在php.ini中启用curl.cainfo指向有效的cacert.pem -
Could not resolve host: mirrors.aliyun.com：公司内网 DNS 可能屏蔽镜像域名，可尝试换用 IP 直连（如118.31.67.52），但需配合hosts文件或自定义curl配置 - 执行
composer update卡在Loading composer repositories with package information：大概率是镜像响应慢或本地 DNS 缓存异常，可加-vvv查看真实请求 URL 和超时日志
国内镜像本质是反向代理，不缓存所有包，首次拉取大体积包（如 laravel/framework）仍可能触发回源，这不是配置错误，而是镜像机制决定的。
