执行 composer config -g repo.packagist https://packagist.org 即可禁用镜像,仅重置全局源地址;若仍走镜像,需检查项目级 composer.json 中 repositories 或 config.repo.packagist 是否覆盖;composer restore 非法命令,恢复镜像应手动设回镜像地址。
composer config -g repo.packagist 是核心命令
禁用镜像本质是把全局配置里的 Packagist 源地址改回官方默认值。执行 composer config -g repo.packagist https://packagist.org 即可,它会直接覆盖当前镜像设置(比如阿里云、腾讯云等)。
注意:这个操作不删除其他镜像相关配置项(如 packagist.org 的 allow_ssl_downgrade),只重置源地址本身。
禁用镜像后仍走镜像?检查是否被项目级配置覆盖
全局配置会被 composer.json 里的 repositories 字段或项目根目录的 composer.json 中的 config.repo.packagist 覆盖。运行 composer config --list --global 查看全局生效值,再运行 composer config --list(不带 --global)对比项目级配置。
- 如果项目级有
"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}],删掉或注释掉整段 - 如果项目级
config下有repo.packagist,用composer config repo.packagist https://packagist.org(无-g)重置
composer restore 镜像?不存在这个命令
composer restore 不是 Composer 内置命令,执行会报错 Command "restore" is not defined。所谓“复原镜像”,其实是重新设回镜像地址,例如:composer config -g repo.packagist https://mirrors.aliyun.com/composer/。
常见误操作是以为 composer self-update 或 composer clear-cache 能恢复镜像——它们只更新二进制或清缓存,不影响源配置。