直接修改 config.json 是最稳的 composer 镜像切换方式，需编辑 ~/.composer/config.json（linux/macos）或 %appdata%\composer\config.json（windows），手动添加含 "packagist": false 的 repositories 字段，并确保 url 为 https://mirrors.aliyun.com/composer/ 且末尾带 /，否则仍会回源导致超时或失败。
如何直接修改 config.json 切换 Composer 镜像源
改镜像源最稳的方式就是手动编辑 config.json，而不是依赖命令行临时设置——后者容易被项目级配置覆盖，且不生效于全局命令（比如 composer create-project）。关键在于确认你改的是哪个 config.json：全局配置在 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），项目级则在当前目录的 composer.json 同级位置。
直接用文本编辑器打开对应文件，确保顶层有 "repositories" 字段；如果没有，就手动加上。注意不要破坏 JSON 格式，尤其末尾逗号和引号闭合。
- 国内常用镜像源地址：
"https://mirrors.aliyun.com/composer/"（阿里云）、"https://packagist.phpcomposer.com"（已停用，别再用） - 必须把
"packagist.org"设为false，否则 Composer 仍会回源请求，拖慢速度甚至失败 - 如果同时设了多个仓库，需按优先级从上到下排列，Composer 会顺序查找
composer config 命令为什么有时不生效
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 看似方便，但实际只写入全局 config.json 的 "repositories" 子项，**不会自动关闭默认 packagist.org**。结果是：包存在时走镜像，不存在时仍去官网查——而官网在国内常超时或被重置连接，导致安装卡死或报错 Could not fetch https://packagist.org/packages.json。
- 正确命令要显式禁用默认源：
composer config -g repos.packagist false -
-g参数必须加，否则只改当前项目，对全局命令无效 - Windows 下若提示权限错误，说明
config.json被锁定或路径不对，建议直接编辑文件更可靠
项目级镜像配置的陷阱：为什么 composer.json 里写 "repositories" 不一定管用
在项目 composer.json 中添加 "repositories" 是常见做法，但它只影响该项目的依赖解析，**不影响 composer install 之前需要下载的插件（如 composer/installers）或全局命令行为**。也就是说，如果你用 create-project 创建新项目，或者某些插件本身依赖 packagist.org，镜像配置还没加载进来，就会失败。
- 项目级配置无法解决“首次运行
composer就卡住”的问题 - 若项目中同时存在
"repositories"和"packagist": false，必须确保"packagist": false在"repositories"外层，否则无效 - 团队协作时，别把镜像源硬编码进
composer.json，应统一用全局配置 + CI 环境变量控制
验证镜像是否真正生效的三个检查点
改完别急着跑 install，先确认三件事：一是 composer config -g repo.packagist 输出是否为你的镜像地址；二是 composer config -g repos.packagist 是否返回 false；三是执行 composer show -p 时，所有包来源是否显示为镜像域名而非 packagist.org。
- 如果
show -p里混着packagist.org，说明某处漏关了默认源 - 某些 IDE（如 PHPStorm）自带 Composer 执行环境，可能缓存旧配置，重启 IDE 再试
- 公司内网若部署了私有仓库，务必确认镜像源与私有源的
"type"和"url"格式一致，否则解析失败
改镜像源这件事，90% 的问题出在没关掉 packagist.org，而不是地址填错了。
