当前全局镜像源可通过composer config -g repo.packagist查看，返回url即生效源；若为空或报错则使用默认packagist.org；项目级配置（composer config repo.packagist）优先级更高。
查看当前全局 Composer 镜像源设置
Composer 默认使用 packagist.org，国内用户常切换为阿里云、腾讯云或华为云镜像源。要确认当前生效的是哪个源，最直接的方式是查 config 命令输出——它反映的是实际生效的配置，而非配置文件内容本身。
运行以下命令：
composer config -g repo.packagist
如果返回类似：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
说明已全局启用阿里云镜像；若返回空或报错 Cannot find a repository named 'packagist'，则大概率仍在用默认源（即未显式配置，走内置 fallback）。
-
composer config -g只显示**全局**配置，不包含项目级composer.json中的repositories覆盖 - 若项目根目录存在
composer.json且含repositories字段，该配置优先级高于全局设置 - 注意：部分镜像源（如华为云）要求 URL 末尾带
/，少写会导致后续 install/update 失败
区分全局配置与项目级覆盖
一个项目可能通过 composer.json 自行指定镜像源，从而绕过全局设置。此时 composer config -g 看不到该项目的实际行为。
检查项目级是否覆盖，执行：
composer config repo.packagist
这个命令在项目目录下运行，会输出当前项目生效的 packagist 源定义（若有）。若无输出，说明项目未覆盖，回退到全局或默认源。
- 项目级配置可写成对象形式（推荐），也可简写为字符串：
"https://mirrors.tencent.com/composer/" - 若项目中同时存在
repositories数组和repo.packagist，后者优先级更高 - 某些旧版 Composer（repo.packagist 简写，必须用完整对象结构
验证镜像源是否真正生效
配置正确 ≠ 请求走镜像。常见问题是 DNS 缓存、HTTP 代理、或镜像源临时不可用，导致 Composer 降级回连官方源而不报错。
最可靠的验证方式是开启详细日志：
composer clear-cache && composer require monolog/monolog -vvv
观察输出中类似这样的行：
Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json
如果 URL 是 packagist.org 或 repo.packagist.org，说明镜像未生效。
-
-vvv日志里首次出现的Downloading行对应元数据请求地址，比composer show更可信 - 若看到
Failed to decode response或SSL certificate problem，可能是镜像源证书异常或本地 CA 不全 - 某些公司内网会拦截并重定向 HTTPS 请求，导致看似走镜像实则被网关转发到其他地址
快速切换或还原镜像源的常用命令
不需要手动编辑配置文件，用 config 命令即可完成切换。注意参数顺序和作用域。
设为阿里云镜像（全局）：
composer config -g repo.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}'
还原为默认官方源（删除全局镜像配置）：
composer config -g --unset repo.packagist
- 字符串值需用单引号包裹，内部双引号保留；JSON 值必须是合法 JSON，否则
config会静默失败 -
--unset比手动删~/.composer/config.json更安全，避免误删其他配置 - 切换后建议立即运行
composer clear-cache，否则旧缓存包仍可能从原源加载
镜像源配置本身很简单，但真正起效依赖于网络路径、缓存状态和优先级规则。最容易被忽略的是项目级 composer.json 的隐式覆盖，以及 -vvv 日志里那个真实的 Downloading 地址——它不会说谎。
