最可靠的方式是执行 composer config -g --unset repos.packagist 并清缓存,但需理清三层配置优先级:环境变量 > 项目级 repositories > 全局配置,且注意字段名应为 repos.packagist(复数),非 repo.packagist(单数)。

直接执行 composer config -g --unset repos.packagist 并清缓存,是最可靠的方式。但多数人还原失败,不是命令错了,而是没理清 Composer 的三层配置优先级和字段名陷阱。
确认当前实际生效的镜像源在哪一层
Composer 查源顺序固定:环境变量 > 项目级 composer.json 中的 repositories > 全局配置(~/.composer/config.json 或 %APPDATA%\Composer\config.json)。只看 composer config -g 输出会误判。
- 查项目级是否覆盖:
composer config repo.packagist(不加-g),如果返回阿里云或清华源地址,说明项目自己写了repositories,全局删了也没用 - 查环境变量是否强制指定:
env | grep COMPOSER_REPO_PACKAGIST(Linux/macOS)或echo %COMPOSER_REPO_PACKAGIST%(Windows),有输出就得先unset或set COMPOSER_REPO_PACKAGIST= - 查全局配置是否真被删干净:
composer config -g repos.packagist应报错Key "repos.packagist" does not exist,而不是返回 URL
删配置还是覆盖?优先选覆盖,且必须写对字段名
Composer 2.x 实际读取的是 repos.packagist(复数、带 s),但很多教程教的是 repo.packagist(单数)。这两个字段互不干扰——你删 repo.packagist,repos.packagist 还在生效。
- 正确删除命令:
composer config -g --unset repos.packagist - 如果不确定是否残留单数写法,顺手也删一次:
composer config -g --unset repo.packagist - 不想删?直接覆盖为官方源更稳妥:
composer config -g repo.packagist composer https://packagist.org/(注意末尾斜杠) - 千万别删
repositories字段本身——它可能还管着私有包源,只删子键repos.packagist
验证是否真走官方源,别信“命令成功”
缓存不清理 = 白操作。Composer 会继续用旧镜像缓存的 packages.json,导致 composer update 找不到新版本、锁文件错乱。
- 必须运行:
composer clear-cache - 验证请求地址:
composer require monolog/monolog --no-install -vvv,滚动日志里找Downloading https://行——正确应含https://repo.packagist.org,不是mirrors.aliyun.com或tuna.tsinghua.edu.cn - 检查元数据 URL:
composer show -p首行应为https://packagist.org/packages.json - 若仍走镜像,90% 是项目
composer.json里还留着"repositories": { ... }块,得手动删或执行composer config --unset repositories
最常被忽略的一点:项目级 repositories 配置一旦存在,全局设置就完全失效——哪怕你删光了所有全局字段,只要项目里写了 "packagist.org": false,Composer 就连不上任何源。这时候必须打开 composer.json,把整个 repositories 块删掉或重置为 {"packagist.org": true}。


















