全局切换 composer 阿里云镜像源只需执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，该命令修改用户级配置文件，优先级低于项目配置但高于默认值，升级 composer 至 2.2.0+ 可避免兼容性问题。
怎么全局切换 Composer 阿里云镜像源
直接改全局配置就行，不用动每个项目。阿里云镜像源地址是 https://mirrors.aliyun.com/composer/，替换掉默认的 Packagist 官方源即可。
执行这条命令就能完成切换：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：-g 表示全局生效，repo.packagist 是 Composer 识别主源的固定键名，不能写成 packagist.org 或其他名字。
- 执行后会在用户目录下（如
~/.composer/config.json）写入配置，所有后续composer install或composer update都会走阿里云 - 如果之前手动改过
config.json，建议先用composer config -g -l查看当前全局配置，避免键名冲突或重复写入 - Windows 用户注意路径权限：若提示“Permission denied”，可能是配置文件被占用或杀毒软件拦截，可尝试管理员权限运行终端
为什么 composer config -g 没生效
常见原因是配置被项目级配置覆盖了。Composer 的配置优先级是：项目根目录 composer.json > 当前用户全局配置 > 系统级默认值。
如果你在某个项目里执行过 composer config repo.packagist ...（没加 -g），那这个项目就会用自己配的源，无视全局设置。
- 检查项目内是否有
"repositories"字段：打开项目根目录的composer.json，搜"repositories"，如果存在且包含packagist.org或空对象，就说明它强制锁死了源 - 临时绕过项目配置：加
--no-plugins --no-scripts不足以解决，得用-n（--no-interaction）配合--ignore-platform-reqs也没用；真正有效的是删掉项目级repositories，或显式重置：composer config --unset repositories - 验证是否真走阿里云：运行
composer diagnose，看输出里 “Repo:” 后面是不是https://mirrors.aliyun.com/composer/
composer create-project 还是走官网？
会走，但前提是没被项目模板自带的 composer.json 覆盖。比如你用 laravel/laravel 模板创建项目，它自带的 composer.json 通常不带 repositories，这时就走你的全局镜像源。
但有些私有模板或老旧脚手架会硬编码官方源，导致第一次 create-project 就卡住或报错。
- 安全做法：加
--repository-url=https://mirrors.aliyun.com/composer/参数强制指定，例如：composer create-project laravel/laravel demo --repository-url=https://mirrors.aliyun.com/composer/ - 这个参数只影响本次命令，不写入任何配置，适合 CI 或临时调试
- 如果模板本身有
repositories，该参数会被忽略——此时只能先create-project，再进目录删掉repositories段，再composer install
镜像源失效或返回 404 怎么办
阿里云镜像不是实时同步，偶尔会有几小时延迟，尤其是新发布的包。更常见的是 Composer 版本太老，不支持 HTTPS 重定向或 SNI，导致连接失败。
典型错误信息：Could not fetch https://mirrors.aliyun.com/composer/p2/monolog/monolog.json, enter your GitHub credentials，或者直接 Connection refused。
- 先确认 Composer 版本：
composer --version，低于2.2.0的版本对阿里云镜像兼容性差，升级最稳妥：composer self-update - 阿里云镜像不支持
packages.json的旧格式请求（v1 API），老版本 Composer 会 fallback 到它，结果 404；升级后自动走 v2 协议 - 如果公司网络限制了
mirrors.aliyun.com域名（比如只放行packagist.org），那就没法用镜像——别折腾代理，换腾讯云镜像（https://mirrors.cloud.tencent.com/composer/）试试，策略不同
composer config -g -l 和 composer diagnose 看一眼真实生效的配置，比反复重装快得多。 
