composer config 命令更安全，因其自动校验键名、类型和 JSON 结构，避免手动编辑 config.json 时的语法错误、字段名拼写错误、type 缺失、路径误配等问题，且能精准控制项目级或全局配置生效范围。
composer config 命令改镜像为什么比手动编辑 config.json 更安全
因为 composer config 会自动校验键名、类型和 JSON 结构，而手写 config.json 容易漏掉逗号、多写括号、错用数组/对象——Composer 遇到语法错误会静默忽略整个 repositories 段，不报错也不生效。
命令行操作天然规避两类高频错误：
-
repo.packagist键名拼成repos.packagist或repository→ 命令强制校验字段名 - type 缺失或写成
"type": "mirror"→composer config -g repo.packagist composer URL中的composer就是 type 值，不可省略
手动编辑时还要自己确认 COMPOSER_HOME 路径是否正确（Windows 是 %APPDATA%\Composer\config.json，不是 %USERPROFILE%\Composer\），而 composer config -g 自动定位。
项目级镜像必须用 composer config repo.packagist，不能用 config -g
加 -g 参数写的是全局配置，对当前项目无效；不加 -g 才会修改当前目录下的 composer.json 的 repositories 字段——这是项目级镜像唯一正经落盘方式。
常见误操作：
- 在项目里执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/→ 全局改了，但当前项目仍走 packagist.org（因为项目级composer.json无repositories，默认启用官方源） - 直接往
composer.json里硬塞{"repositories": [{"type":"composer","url":"..."}]}→ 没禁用packagist.org，Composer 仍会 fallback 到官方源拉元数据
正确做法：先运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/，再检查生成的 composer.json 是否含 "packagist.org": false 在 repositories 数组首位。
改完必须 clear-cache，否则日志里看到的还是旧地址
Composer 缓存的是 packages.json 文件内容，不是 URL。即使你把镜像 URL 改对了，缓存里还存着从 packagist.org 下载的旧元数据，composer update 依然会解析出旧版本号，甚至装错包。
验证是否真生效，不能只看下载速度：
- 运行
composer clear-cache（不是composer dump-autoload） - 再跑
composer update -vvv | grep GET，确认输出里出现GET https://mirrors.aliyun.com/composer/packages.json这类请求 - 如果看到
GET https://packagist.org/packages.json，说明镜像没走通，回去查composer config -g repo.packagist输出和composer diagnose里的Repo packagist.org:行
Windows 用户改完要重开终端，Linux/macOS 用户要注意权限
Windows 下 composer config -g 写入注册表或 AppData 后，当前 CMD/PowerShell 不会自动 reload 环境变量，composer config -g repo.packagist 查不到新值——必须新开终端。
Linux/macOS 上更隐蔽的问题是权限：
- 用
sudo composer config -g→ 写进 root 用户的~/.composer/config.json，普通用户运行composer时读的是自己的 home 目录，根本看不到 - CI/CD 流水线常用
root用户执行，但本地开发用普通用户，结果本地能走镜像、CI 却连不上
查实际生效路径最准的方式是运行 composer config --home，然后去那个目录下看 config.json 内容，别信“我刚刚明明执行了命令”。
