直接执行composer config -g repo.packagist composer https://packagist.org可强制恢复官方源，该命令绕过fallback逻辑、兼容Composer 2.0+全版本；删配置易因字段名错误、fallback缺陷或项目级覆盖而失效，且必须清缓存并分层验证环境变量、项目配置及真实请求URL。
直接执行 composer config -g repo.packagist composer https://packagist.org 就能强制恢复官方源，这是 Composer 2.0+ 全版本最稳的操作；删配置反而容易失效，尤其在 2.2–2.4 小版本里可能卡住或 fallback 失败。
为什么 composer config -g --unset repos.packagist 常常没用
这个命令看似“清空”，实际有三重陷阱：
- 字段名必须是
repos.packagist（复数），写成repo.packagist（单数）不会报错，但删的是个不存在的键，镜像照旧生效 - Composer 2.2–2.4 中删掉该字段后，fallback 逻辑有缺陷，可能报
Could not parse version constraint或静默走错源 - 即使删成功了，只要项目
composer.json里有"repositories"字段（哪怕只是[]或{"packagist.org": false}），全局配置就完全被屏蔽
怎么确认当前真正生效的镜像源
别只看 composer config -g 输出——Composer 查源顺序是：环境变量 > 当前项目 composer.json > 全局 config.json。必须分层验证：
- 查环境变量：
env | grep COMPOSER_REPO_PACKAGIST（Linux/macOS）或echo %COMPOSER_REPO_PACKAGIST%（Windows），有输出就得先unset或清空 - 查项目级配置：
composer config repo.packagist（不加-g），如果返回阿里云地址，说明composer.json里有"repositories"块，得手动删或运行composer config --unset repositories - 查真实请求：
composer require monolog/monolog --no-install -vvv，滚动日志里找Downloading https://行——正确应为https://repo.packagist.org，不是任何镜像域名
改完配置后必须清缓存，否则等于白改
Composer 把镜像的 packages.json 快照存在缓存里（路径如 ~/.composer/cache/repo/），配置改对了，缓存不清理，它照样按旧快照找包，结果就是 Package not found、composer update 解析失败、锁文件更新异常。
- 必须执行：
composer clear-cache，确认输出含Clearing cache (all) - 验证是否清干净：
ls -la ~/.composer/cache/repo/（Linux/macOS）或dir %APPDATA%\Composer\cache\repo\（Windows）应为空或只剩空目录 - 再跑一次
composer show -p | head -3，第一行 URL 必须是https://repo.packagist.org/packages.json
最容易被忽略的是三层覆盖关系：环境变量能压倒一切，项目 composer.json 里的 "repositories" 会彻底屏蔽全局设置，而缓存不清理会让所有配置变更失效——这三者只要漏掉一个，你就还在用镜像源。
