composer config --global 是唯一安全的全局配置写入方式，它自动校验json、处理路径转义、写入正确位置并刷新缓存；手动编辑易出错且composer会静默忽略无效config.json。
composer config --global 是唯一安全写入方式
手动编辑 config.json 文件几乎必然出错：多一个逗号、用中文引号、路径没转义、结尾少个 /，Composer 就会静默跳过整个文件，不报错也不提示，后续所有命令都继续走默认路径。你改的文件它根本没读。
composer config --global 命令自动校验 JSON 格式、处理路径转义、写入正确位置（新版 Composer 优先读 ~/.config/composer/config.json 或 %APPDATA%\Composer\config.json），并触发内部缓存刷新。必须显式带 --global（或 -g），漏掉就直接写进当前项目的 composer.json，不是全局生效。
- 值含空格或反斜杠时，必须用英文双引号包裹，例如：
composer config --global cache-dir "/data/composer-cache" - 嵌套键不能一次设全，比如配私有仓库要分步：
composer config --global repositories.myrepo.type "composer"和composer config --global repositories.myrepo.url "https://example.com" - 路径必须是绝对路径，
./cache或cache这类相对路径会被忽略
怎么确认配置真的写进去了
别只看命令返回 OK。真正验证方式只有一种：composer config --global cache-dir（或其他具体键名）必须输出你刚设的完整路径字符串，比如 /data/composer-cache。如果返回空、null、或报 Key not found，说明根本没写进去。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
再进一步验证行为：
- 运行
composer clear-cache，观察日志里清理的是不是你设的新路径 - 执行
composer install -vvv，搜索日志里的Writing into cache行，看路径是否匹配 - 用
composer config --global --list --verbose查看实际加载的配置文件路径和全部已设项
常见路径误判和环境干扰
你以为改了，其实 Composer 根本没读那个文件：
- 在
~/.composer/config.json和~/.config/composer/config.json之间猜路径？新版 Composer 优先读后者，前者可能被完全忽略 - 设置了
COMPOSER_HOME环境变量但指向空目录或权限不足目录，composer config --global写入失败却不报错，实际配置仍为空 - 用
sudo composer执行过命令，导致后续读取的是/root/.composer/config.json，而你改的是当前用户的文件 - Git Bash 下编辑
%APPDATA%\Composer\config.json，但 Git Bash 不展开 Windows 环境变量，实际写的是 Cygwin home 目录下的文件
Windows 和 Linux/macOS 路径写法差异
路径格式稍有不慎就会失效：
- Windows 上必须用英文双引号包裹含空格或反斜杠的路径：
composer config --global cache-dir "C:\Users\YourName\AppData\Local\Composer\Cache" - Linux/macOS 绝对路径不能以
~开头（shell 不展开），要用/home/username/.composer/cache这类完整路径 - 目标目录必须存在且当前用户有读写权限，否则后续
composer update会卡住或报Permission denied - PATH 中添加 Composer 可执行路径时，末尾不要带反斜杠
\，例如C:\ProgramData\ComposerSetup\bin\可能解析异常，应写为C:\ProgramData\ComposerSetup\bin
