composer config -g repos.packagist 可直接查看全局 Packagist 镜像配置，返回 JSON 表示已设置对应镜像，空或报错则使用官方源；键名必须为 repos.packagist（复数），旧版 repo.packagist.org 已弃用。
composer config -g repo.packagist 如何查看全局镜像源
直接运行命令就能查到当前全局配置的 Packagist 镜像地址，这是最常用、最可靠的查询方式：
composer config -g repo.packagist
如果返回类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，说明已配置阿里云镜像；若返回空或报错 Could not find package repo.packagist in global config，代表当前用的是官方源（https://packagist.org）且未显式配置镜像。
注意：repo.packagist 是 Composer 2.2+ 引入的专用键名，旧版本（如 1.x）需用 repo.packagist.org，但该写法在新版本中已被弃用，强行使用会触发警告。
composer config -g repos.packagist 如何修改为国内镜像
设置镜像必须用正确的键名 repos.packagist（注意是 repos 复数 + packagist 小写），否则配置不生效：
composer config -g repos.packagist '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'
常见错误包括：
- 漏掉
-g参数 → 只改当前项目，不是全局 - 写成
repo.packagist（单数）→ 新版本忽略该配置 - URL 末尾多加
/packages.json→ 导致 404，镜像 URL 应以/结尾 - 用双引号包裹 JSON 时未转义内部双引号 → Shell 解析失败，建议统一用单引号包住整个 JSON 字符串
为什么 composer config -g 显示不出镜像地址
有三种典型情况会导致 composer config -g 列表里看不到 repos.packagist：
- 根本没配过镜像 → 默认走官方源，无需显示
- 配置写到了项目级
composer.json里 →-g查不到，得进项目目录执行composer config repo.packagist - 用了过时的 alias 方式（如
composer config -g packagist https://xxx）→ 这种写法早已失效，不会存入配置文件
真实配置文件路径是 ~/.composer/config.json（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Composer\config.json（Windows），可直接打开确认 repos 字段是否存在。
切换镜像后 update 仍慢或报错怎么办
改完镜像不生效，大概率是本地缓存或 DNS 问题：
- 清除 Composer 缓存：
composer clear-cache - 确认网络能直连镜像域名：
curl -I https://mirrors.aliyun.com/composer/（应返回 200 或 302） - 检查是否被公司代理或 hosts 干扰 —— 有些企业网络会劫持
packagist.org域名，即使配置了镜像，Composer 内部仍可能尝试解析原域名 - 临时禁用 HTTPS 验证（仅调试）：
composer config -g secure-http false，排除证书问题
镜像切换不是一劳永逸的事，不同镜像同步延迟不同，阿里云通常最快，腾讯云偶尔滞后几小时，遇到特定包拉不到，先 composer clear-cache 再试一次。
