composer.json非法字符导致json解析失败，常见原因包括中文引号、bom头、零宽空格、全角符号等；应使用php -r命令或jsonlint.com快速定位，而非依赖composer validate。
composer.json 里有非法字符，JSON 解析直接失败
报错类似 JSON parse error on line 12 at column 5 或 Unexpected character，根本不是 Composer 功能问题，而是文件本身不合法。90% 的情况是肉眼难见的污染：中文引号、BOM 头、零宽空格（U+200B）、全角冒号或末尾逗号。
- 立刻执行
php -r "json_decode(file_get_contents('composer.json')) || die('JSON error: '.json_last_error_msg());"—— PHP 8.0+ 还会返回偏移量（如offset 123），配合编辑器「显示不可见字符」功能就能秒定位 - 粘贴内容到
jsonlint.com，它会高亮标出所有非法位置，比扫全文件快十倍 - 用
jq '.' composer.json（需先装jq）：失败时直接输出行列号，比composer validate更底层、更敏感
composer validate 通过但 install 仍失败？它根本不校验语义
composer validate 只检查 JSON 结构 + 基础 schema（比如 name 是否存在、require 是否为空），对真实环境完全不敏感。很多“合法但致命”的配置它放行，install 时才爆雷。
-
"require": { "monolog/monolog": "dev-main" }—— validate 通过，install 报Could not find package -
"autoload": { "psr-4": { "App\": "src/" } }，但项目里根本没有src/目录 —— validate 通过，composer dump-autoload却警告路径不存在 -
"config": { "platform": { "php": "8.3" } }，而本地 PHP 是 8.1 —— validate 不检查运行时兼容性 - 真正暴露语义问题的命令是：
composer install --dry-run --no-interaction（Composer 2.5+ 稳定支持）
镜像配置写错导致 “非法配置选项” 提示
错误提示里出现 Invalid argument exception 或 Unknown configuration option，大概率是全局镜像配置语法不对，不是网络或权限问题。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
repo.packagist必须是单数，写成repos.packagist或repositories.packagist.org（2.2+ 才认）都无效 - 正确命令必须带
composer类型值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须 HTTPS 且以
/结尾：写成https://mirrors.aliyun.com/composer（缺斜杠）会导致拼出/composerpackages.json这种非法路径 - 必须加
-g，否则只改当前项目composer.json，换目录就失效
CI/CD 或宝塔里报错，别只看本地配置
你用 root 配了全局镜像，但 CI 脚本或宝塔实际跑的是 www 用户，配置根本没加载进去。此时 composer config -g repo.packagist 输出为空或不是 JSON 对象，说明配置压根没存成功。
- 在 CI 中用
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/单独配 - 运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址；只看composer config输出没用 - 检查项目级
composer.json是否含"repositories"字段：哪怕只是空数组[]，也会完全屏蔽全局镜像 - 执行
composer config --unset repositories（注意没-g）临时清掉项目级配置
格式错误最麻烦的不是修复动作，而是污染源往往藏在复制粘贴、AI 生成、编辑器自动转换或 Git 换行符处理里——下次改完 composer.json，顺手跑一遍 php -r "json_decode(...)"，比等 install 报错再排查快得多。
