Composer 全局配置应统一用 composer config -g 命令操作，存于系统指定路径，避免手动编辑；支持设置 GitHub 令牌、镜像源、认证存储等，需注意键名拼写、引号包裹值及嵌套结构，并用 -l 查看生效配置。
修改 Composer 全局配置用 config 命令就行
Composer 的全局配置存放在 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），直接编辑文件容易出错，推荐统一用 composer config 命令操作。它能自动处理 JSON 格式、路径拼接和作用域隔离，比手改安全得多。
composer config -g 是修改全局配置的唯一正确入口
加 -g（global）参数是关键，漏掉就会改到当前项目的 composer.json 里，导致依赖安装行为异常却找不到原因。
-
composer config -g github-oauth.github.com "your_token"：设置 GitHub 访问令牌，避免频繁限流 -
composer config -g repo.packagist composer https://packagist.phpcomposer.com：切换国内镜像源（注意协议必须是https） -
composer config -g store-auths true：允许保存私有仓库认证信息（默认为true，设为false则每次都要输密码） -
composer config -g --unset repos.packagist：删除已配置的 packagist 源（比如想彻底禁用官方源）
常见错误：路径、作用域、JSON 嵌套层级写错
很多人执行成功但配置不生效，问题往往出在键名拼写或嵌套结构上。例如：
- 想改缓存目录，误写成
composer config -g cache-dir /path/to/cache→ 实际应为composer config -g cache-dir "/path/to/cache"（值必须加引号，否则空格会截断） - 想配置多个仓库，误用
composer config -g repos.foo ...→ 正确写法是composer config -g repos.foo.type "composer"和composer config -g repos.foo.url "https://example.com"，不能一次设整个对象 - 执行后没生效？运行
composer config -g -l查看实际生效的全局配置，对比是否拼错键名（如把github-oauth写成github_oauth）
配置变更后，composer update 不会自动重读全局设置
全局配置主要影响后续命令的行为，比如 install、require、create-project，但不会触发已有 vendor/ 的重建。如果你刚切了镜像源，又遇到包拉不下来，别急着重装 Composer——先确认：
composer clear-cache再试。另外，某些配置（如
store-auths）只在下次需要认证时才起作用，不是立即生效的开关。
改全局配置最常被忽略的点是：以为设了就“马上全局生效”，其实得看具体命令是否读取该配置项，以及是否被项目级配置覆盖。多用 -l 和 --global 参数交叉验证，比猜快得多。 
