真实路径需用composer config --global --list命令确认，首行“Global configuration file”即为准确位置；新版Composer（2.x）只认config.json，且默认不存在，须执行composer config --global后生成。
别猜路径，用 composer config --global --list 一眼看到真实配置文件位置——新版 Composer（2.x）不认 composer.json，只读 config.json，且该文件默认不存在，必须执行过全局配置操作才会生成。
怎么确认全局配置文件 config.json 的真实路径
很多人直接去 ~/.composer/composer.json 或 %USERPROFILE%\AppData\Roaming\Composer\composer.json 找，但那是旧版残留或误建的文件。Composer 2.x 只加载 config.json，且路径受 COMPOSER_HOME 环境变量控制，可能被覆盖。
- 最可靠方式：运行
composer config --global --list，第一行输出的Global configuration file就是当前生效的完整路径，例如/home/alice/.composer/config.json或C:\Users\Alice\AppData\Roaming\Composer\config.json - 如果想只看 home 目录（即
config.json所在父目录），用composer global config home --absolute，它不依赖配置是否已初始化，更轻量 - 注意：
composer config --list（没加--global）查的是当前项目目录下的composer.json，不是全局的
为什么 composer config --global 命令本身会“创建”配置文件
新版 Composer 默认不生成 config.json。首次运行 composer config --global cache-dir /tmp/composer-cache 或甚至只是 composer config --global（不带键值），Composer 才会在 COMPOSER_HOME 下创建空的 config.json 并写入基础结构。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 不执行任何
config --global操作，config.json文件就不存在，composer config --global --list仍会显示路径，但文件是空的或根本没生成 - 手动新建
config.json容易格式出错（比如末尾多逗号、用单引号），推荐始终用composer config --global key value修改，由 Composer 自动维护 JSON 格式 - 若误删了
config.json，不用恢复备份，直接再执行一次任意config --global设置即可重建
cache-dir 和 bin-dir 这类路径配置为什么必须设在全局
cache-dir、bin-dir、github-oauth 等属于全局级配置项，项目级 composer.json 中设置它们无效——Composer 启动时只从全局或系统级配置读取这些字段。
- 验证是否生效：运行
composer global config --list | grep cache-dir，有输出且非空才表示缓存路径已被重定向 -
bin-dir路径影响所有composer global require安装的命令能否直接调用，但它本身不决定 PHP 扩展是否可用；即使路径正确、PATH已配，phpstan报错仍可能是 PHP 版本不兼容或缺失json扩展 - 修改
bin-dir后，已安装的全局命令不会自动迁移，需重新composer global require一遍
最容易被忽略的一点：全局配置的生效前提是 Composer 能定位到正确的 COMPOSER_HOME，而这个环境变量可能被 shell 配置、IDE 启动方式甚至 Docker 容器覆盖。不要假设路径固定，每次排查前先跑一遍 composer config --global --list —— 它输出的才是唯一可信的事实。
