Composer全局镜像设置错误需先用composer config --list --global确认生效路径，再用composer config --global --unset repos.packagist或composer config --global repo.packagist composer https://packagist.org还原，避免手动删改JSON。
Composer 全局镜像一旦设置错误，会导致所有项目都走错源，安装包慢、失败甚至拉到不兼容版本。还原的关键不是“删配置”，而是确认当前生效的全局配置位置，并清空或覆盖它
如何确认当前生效的全局 config.json 路径
Composer 的全局配置优先级是：命令行参数 > 当前项目 composer.json > 全局 config.json。全局配置默认存在用户家目录下，但具体路径因系统而异：
- Linux/macOS：
~/.composer/config.json - Windows：
%APPDATA%\Composer\config.json（通常是C:\Users\{用户名}\AppData\Roaming\Composer\config.json）
最稳妥的方式是直接运行：
composer config --list --global如果输出里有
repositories.packagist.org 或 repo.packagist 相关条目，说明镜像已生效；路径则看第一行 “Global config file” 后面的路径。
执行还原：用官方源覆盖现有镜像配置
不要手动删文件或编辑 JSON——容易格式出错或漏字段。直接用 Composer 命令重置即可：
- 清除当前全局镜像设置：
composer config --global --unset repos.packagist
- 或更彻底地，强制恢复为官方源（推荐）：
composer config --global repo.packagist composer https://packagist.org
注意这里用的是repo.packagist（旧键名，仍被支持），不是repositories.packagist.org（v2 风格，需额外处理） - 验证是否生效：
composer config --global repo.packagist
应输出{"type": "composer", "url": "https://packagist.org"}
为什么 composer config --global --unset repositories 不起作用
因为 repositories 是个数组，--unset 对数组项无效；而且 Composer 默认不会把 repositories 写进全局配置——它只在你显式执行 config repositories.xxx 时才写入。真正生效的镜像配置通常来自以下之一：
-
repo.packagist（字符串键，最常见） -
repositories.packagist.org（对象键，Composer 2.0+ 推荐方式） -
repositories数组里自定义的 packagist 替换项
所以还原时要对症下药：
若之前用 composer config --global repos.packagist composer https://mirrors.aliyun.com/composer/ 设置，则用 --unset repos.packagist；
若用的是 composer config --global repositories.packagist.org '{"type":"composer","url":"https://mirrors.tuna.tsinghua.edu.cn/composer/"}'，就得用 --unset repositories.packagist.org。
最容易被忽略的是：某些国内镜像文档会教你在全局 config 里加 fxp-asset-plugin 或修改 http-basic，这些残留字段不会影响镜像，但可能干扰私有包认证——还原后建议顺手跑一遍 composer config --global --list | grep -E "(repo|asset|auth)" 快速扫一眼。
