直接删掉全局配置里的 repos.packagist 字段并清缓存即可还原为官方源;需确认字段名正确、作用域为全局、无环境变量或项目级配置覆盖,否则仍可能走镜像。

直接删掉全局配置里的 repos.packagist 字段,再清缓存,就能还原为官方源。 Composer 没有“一键恢复默认”命令,它的行为逻辑很简单:只要全局配置里没有 repos.packagist 这个键,就自动回退到 https://packagist.org。删错字段名、漏清缓存、或被项目级配置覆盖,都会让你以为“还原失败”。
执行 composer config -g --unset repos.packagist 但没生效?检查字段名和作用域
这个命令只删全局配置(%APPDATA%\Roaming\Composer\config.json 或 ~/.composer/config.json),对当前项目无效。常见问题包括:
- 写成
repo.packagist(单数)——这是早期某些文档的错误写法,Composer 不报错但不识别,得额外补删:composer config -g --unset repo.packagist - 漏掉
-g参数,结果只删了当前项目composer.json里的repositories,全局配置还在 - 字段名拼错,比如
repos.packagist.org或packagist.org,这些都不会被识别,删了也白删
删完还是走阿里云?先验证,再排查干扰源
别只看命令是否报错,要实测请求地址:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 查配置是否真没了:
composer config -g repos.packagist应返回Key "repos.packagist" does not exist或空输出 - 查实际请求:
composer require monolog/monolog --no-install -vvv,在日志里搜Downloading https://,正确应出现https://repo.packagist.org,不是mirrors.aliyun.com - 如果仍走镜像,大概率是当前项目
composer.json里还留着repositories块,运行composer config --unset repositories清掉它
还有哪些地方可能偷偷覆盖镜像设置?
除了全局和项目级配置,还有三个常被忽略的覆盖层:
- 环境变量:
COMPOSER_REPO_PACKAGIST,Linux/macOS 执行echo $COMPOSER_REPO_PACKAGIST,Windows 执行echo %COMPOSER_REPO_PACKAGIST%,如果输出非空,用unset COMPOSER_REPO_PACKAGIST(Linux/macOS)或set COMPOSER_REPO_PACKAGIST=(Windows)清除 - 项目
composer.json里写了"repositories": {"packagist.org": false}这种禁用默认源的写法——这会彻底关掉官方源且不提供替代,必须手动删整个repositories对象 - 某些老旧脚手架(如旧版 Laravel 安装器)生成的模板自带硬编码源,
composer create-project第一次拉取时就绕过了你的全局设置,只能进项目后立刻composer config --unset repositories
最麻烦的不是命令不会敲,而是删了一处,还有三处没找全。尤其 COMPOSER_REPO_PACKAGIST 环境变量和项目里那个 "packagist.org": false 的写法,不主动查根本看不到。

















