直接修改 config.json 可行但需注意位置、格式和作用域：全局配置在 ~/.composer/config.json，项目级须改 composer.json 的 config 字段；镜像须写入 repositories 数组并禁用 packagist.org，推荐中科大或阿里云镜像；改后需 clear-cache 并用 composer show -p 验证。
直接改 config.json 是可行的，但必须改对位置、格式和作用域，否则 Composer 会忽略或报错。
确认 config.json 文件位置
Composer 的配置分全局和项目两级，修改前先搞清你要配哪一层：
- 全局配置（影响所有项目）：运行
composer config -g home查看全局 config 目录，config.json在该路径下的config.json文件中（通常为~/.composer/config.json或%APPDATA%\Composer\config.json） - 项目配置（仅当前目录生效）：在项目根目录下找
composer.json同级的config.json—— 注意：这不是标准文件，Composer 默认不读它；你真正要改的是项目级composer.json中的config字段
⚠️ 常见错误：把镜像配置写进独立的 config.json 文件却放在项目里，Composer 根本不认。它只认 composer.json 里的 config，或全局 ~/.composer/config.json。
在 config.json 中正确添加 mirror 配置
镜像必须写在 repositories 数组里，且类型为 composer，同时禁用 packagist.org 原源（否则优先走原站）：
{
"repositories": [
{
"type": "composer",
"url": "https://packagist.phpcomposer.com"
},
{
"packagist.org": false
}
]
}
注意点：
-
packagist.org必须作为对象键写在repositories里，值为false，不能写成"packagist": false或放在别处 - 国内常用镜像地址已变更：
https://packagist.phpcomposer.com已停用；推荐用https://packagist.mirrors.ustc.edu.cn（中科大）或https://mirrors.aliyun.com/composer（阿里云） - 如果用的是 Composer 2.0+，部分镜像需加
"options": {"ssl": {"verify_peer": false}}（仅调试用，生产环境不建议关 SSL 校验）
验证配置是否生效
改完别急着跑 install，先用命令确认实际加载的源：
- 查看当前生效的仓库列表：
composer config --list | grep repositories - 更直观的方式：
composer show -p（显示所有包源），或composer diagnose检查配置合法性 - 执行
composer clear-cache清掉旧缓存，再试composer require monolog/monolog，观察下载 URL 是否来自你配的镜像域名
⚠️ 容易被忽略：如果你之前用过 composer config repo.packagist composer https://xxx 这类命令配置过，它会写进 config.json 生成一个 repo.packagist 键——这和手动写 repositories 数组冲突，会导致镜像不生效。此时应删掉 repo.packagist 字段，统一用数组方式管理。
手动改 config.json 看似简单，但字段嵌套、布尔值写法、源禁用逻辑、缓存残留这四点，任何一个出错都会让镜像“看起来配了，实则没走”。尤其多人协作时，项目级配置容易被 .gitignore 掉，导致本地有效、CI 失效。
