最准最快的方式是执行 composer config -g repo.packagist，直接读取全局配置文件，三秒内确认镜像是否生效；输出完整 json 对象表示成功，为空或报错则未生效或版本不兼容。
直接读取全局配置文件 ~/.composer/config.json
最准的方式不是猜、不是看文档、不是信 composer diagnose，而是打开配置文件本身。Composer 全局配置只写在固定路径：~/.composer/config.json（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Composer\config.json（Windows）。只要该文件存在且 JSON 语法合法，composer config -g 的所有操作就落在此处。
执行以下命令即可确认内容是否真实写入：
-
cat ~/.composer/config.json | jq '.repositories'（Linux/macOS，需安装jq） -
type %USERPROFILE%\AppData\Roaming\Composer\config.json（Windows cmd） - 手动用文本编辑器打开该文件，查找
"repo.packagist"或"repositories.packagist.org"字段
注意：如果文件里压根没有 repo.packagist 字段，但 composer config -g repo.packagist 却返回了值，说明你当前终端用户和配置文件所属用户不一致（比如用了 sudo 写进 /root/.composer/，而 PHP 进程跑在 www 用户下）。
用 composer config -g repo.packagist 验证输出格式
这个命令不是“查有没有”，而是“查写得对不对”。它只读配置文件，不走网络、不查缓存、不看项目级设置，三秒内给出结果。
成功写入的唯一正确输出是完整 JSON 对象，形如：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
其他任何情况都代表失败：
- 输出为空 → 键名拼错（比如
repos.packagist多了个s）或根本没执行-g - 输出
Key "repo.packagist" does not exist→ 字段未写入，或写到了项目级而非全局 - 输出
{"type": "composer", "url": ""}→ URL 值为空，常见于命令漏掉 URL 参数 - PowerShell 下报错或截断 → URL 被当参数解析，改用
composer config -g "repo.packagist"
区分 Composer 2.2+ 和旧版本的键名差异
Composer 2.2+ 已废弃 repo.packagist，改用 repositories.packagist.org，且必须拆成两步设置：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
composer config -g repositories.packagist.org.type composercomposer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/
如果你用的是 2.2+ 版本，但还在查 repo.packagist，永远得不到有效输出——它被静默忽略。验证方式变成：
-
composer config -g repositories.packagist.org.type→ 应输出composer -
composer config -g repositories.packagist.org.url→ 应输出带结尾/的镜像地址
漏掉 .type 或 URL 少斜杠，会导致请求路径拼成 /p2//monolog/monolog.json，404 后 fallback 到官方源，但命令本身不报错。
检查环境变量是否覆盖了配置
COMPOSER_REPO_PACKAGIST 环境变量优先级高于所有配置文件，会直接接管镜像地址，且不体现在 config -g 输出中。
排查方法：
- Linux/macOS：
echo $COMPOSER_REPO_PACKAGIST - Windows cmd：
echo %COMPOSER_REPO_PACKAGIST%
如果输出非空（比如 https://packagist.org），那无论 config.json 里写什么，实际都走这个地址。临时禁用测试：
- Linux/macOS：
unset COMPOSER_REPO_PACKAGIST - Windows cmd：
set COMPOSER_REPO_PACKAGIST=
配置文件写对了，不代表它真被用上——环境变量、项目级 repositories、缓存、代理，任何一个环节都可能绕过你的配置。
