还原 Composer 镜像源需覆盖三层配置中实际生效层（环境变量＞项目级＞全局），最稳方式是执行 composer config -g repo.packagist composer https://packagist.org/ 显式设为官方源，再清缓存并验证真实请求URL是否含 repo.packagist.org。
还原 Composer 镜像源不是“一键回退”，而是清除或覆盖三层配置中实际生效的那一层——环境变量 > 项目级 composer.json > 全局 config.json。直接删配置项常失败，最稳的方式是显式覆盖为官方地址。
为什么 composer config -g --unset repos.packagist 经常没用
这个命令本身没问题，但容易踩三个坑：
- 字段名写错：必须是
repos.packagist（复数repos），写成repo.packagist（单数）不报错也不生效 - 项目级配置优先级更高：只要当前目录
composer.json里有"repositories"字段，哪怕内容为空或只写了{"packagist.org": false}，全局设置就完全被屏蔽 - 环境变量劫持：如果设置了
COMPOSER_REPO_PACKAGIST，它会直接跳过所有 JSON 配置，连config -g都查不到
推荐的还原方式：用覆盖代替删除
执行这条命令，兼容所有 Composer 2.x 版本，绕过 fallback 逻辑，不依赖字段是否存在：
composer config -g repo.packagist composer https://packagist.org/
注意点：
-
repo.packagist是单数，和设置时一致 -
composer是 type 值，不能省略 - URL 必须带末尾
/，否则静默 fallback 到官方源（但日志里不提示） - 这条命令不会动项目级配置，只确保全局层明确指向官方源
如何确认真正还原成功了
别只看 composer config -g repo.packagist 输出，它可能显示空或旧值，而实际请求已走别处。要验证三层：
- 查环境变量：
echo $COMPOSER_REPO_PACKAGIST（Linux/macOS）或echo %COMPOSER_REPO_PACKAGIST%（Windows），有输出就得先 unset/set 空 - 查项目级：
composer config repo.packagist（不加-g），看是否返回阿里云或清华源地址 - 查真实请求：
composer require monolog/monolog --no-install -vvv 2>&1 | grep "Downloading https"，最终 URL 应含repo.packagist.org，不是任何镜像域名
项目级配置怎么清理
如果 composer.json 里硬编码了 "repositories"，全局换源完全无效。快速处理：
- 检查是否存在：
grep -A5 '"repositories"' composer.json - 安全清空（保留其他字段）：
composer config --unset repositories - 手动编辑：删掉整个
"repositories": { ... }块，包括花括号和前后逗号（避免 JSON 语法错误） - 已有
composer.lock？它会固化旧源地址，还原后务必删掉vendor/和composer.lock再重装
最易被忽略的是环境变量和项目级 repositories 的双重覆盖——它们不报错、不提示，只默默让全局配置失效。验证必须落到网络请求层面，而不是配置文件读取结果。
