Composer 全局镜像源改不了？大概率是用了错误的命令或权限不对，不是镜像本身失效。
如何确认当前全局镜像配置
运行以下命令查看是否已设置镜像源，以及它作用在哪个配置层级：
composer config -g repo.packagist
如果输出类似 {"type": "composer", "url": "https://packagist.phpcomposer.com"}，说明已设；若报错或为空，则未生效。注意：repo.packagist 是旧版键名，新版 Composer（2.0+）应使用 repositories.packagist.org。
一键设置国内镜像（推荐清华、阿里云）
直接覆盖全局配置，无需手动编辑文件。两个主流镜像任选其一：
- 清华镜像（稳定、同步快）：
composer config -g repos.packagist composer https://packagist.phpcomposer.com
- 阿里云镜像（兼容性好）：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
⚠️ 注意：repos.packagist 是正确键名（复数 repos，不是 repo），且必须带 composer 类型声明；漏掉会导致 composer install 报错 Invalid repository type: composer。
为什么 composer config -g mirror 不起作用
这是常见误区——mirror 并非 Composer 内置配置项，而是某些第三方脚本或旧教程自定义的字段，官方不识别。真正生效的是 repos.packagist（或 repositories.packagist.org）。
- Composer 1.x：用
repos.packagist - Composer 2.2+：建议用
repositories.packagist.org（更规范）：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 若执行后仍走国外源，检查是否有项目级配置干扰：
composer config repo.packagist（无-g）会覆盖全局
验证是否生效 & 常见失败点
运行 composer diagnose，重点看输出中是否包含 Repo packagist.org: https://mirrors.aliyun.com/composer/ 这类提示。若仍显示 https://packagist.org，可能是：
- 终端未刷新环境（尤其是 Windows 下 cmd / PowerShell 切换后需重开）
- 当前目录存在
composer.json且内含"repositories"字段，优先级高于全局 - 使用了
sudo composer config -g ...（Linux/macOS），导致写入 root 用户配置，而普通用户运行时读取的是自己的配置 - 镜像 URL 末尾多加了
/packages.json或少写了https://，导致解析失败
最稳妥的验证方式：新建空目录，运行 composer init -n && composer require monolog/monolog，看下载地址是否为镜像域名。
