Composer配置文件格式在线校验与修复的推荐工具（工具分享）-composer-PHP中文网

最准的校验方式是用 php -r 直接解析 config.json，因 composer 无内置命令校验该文件，composer validate 完全无效；需检查中文引号、末尾逗号、bom 头及 repo.packagist 键名与字段完整性。

composer配置文件格式在线校验与修复的推荐工具（工具分享）

用 php -r 直接解析 config.json 是最准的校验方式

Composer 没有内置命令校验 config.json，靠 composer validate 完全无效——它只读 composer.json，对全局或项目级配置文件视而不见。真正能暴露语法问题的，只有让 PHP 自己解析。

运行这行命令就能立刻知道有没有错：

php -r "$j = file_get_contents('config.json'); $d = json_decode($j); if (!$d) { echo 'JSON error: ' . json_last_error_msg() . "\n"; }"

报 Unexpected character？大概率是中文引号、全角冒号或零宽空格（U+200B）混进去了
报 Syntax error？重点查 repositories 数组最后一项后面有没有多加逗号
报 Malformed UTF-8 characters？文件带 BOM 头，用 file -i config.json 看是否含 with-bom

jsonlint.com 适合快速定位错误行号

把 config.json 内容粘贴到 jsonlint.com，它会直接标出哪一行哪个字符非法。比手动逐行排查快得多，尤其适合从网页复制镜像配置后出现的隐性污染。

注意两点：

别用记事本保存过该文件——Windows 记事本默认加 BOM，VS Code 打开时右下角要确认显示“UTF-8”而非“UTF-8 with BOM”
粘贴前删掉所有注释（JSON 不支持 // 或 /* */），哪怕只是临时加的说明也得先去掉

composer config -g repo.packagist 输出才是真实生效配置

格式没错 ≠ 配置有效。composer config -g repo.packagist 的输出必须是完整 JSON 对象，比如：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}

如果输出是 null 或报错，说明键名写错了——常见错误包括：

写成 repos.packagist（多一个 s）或 repositories.packagist.org（新版不认）
url 值末尾没斜杠，如 "https://mirrors.aliyun.com/composer" → 必须是 "https://mirrors.aliyun.com/composer/"
漏了 "type": "composer" 字段，哪怕 url 正确也会静默失效

换源后不清缓存，等于没换

改完 config.json 或执行 composer config -g repo.packagist ... 后，必须立刻运行 composer clear-cache。否则 Composer 仍从旧缓存里读取 packages.json 快照，导致 composer install 找不到包、版本解析失败、甚至卡在 “Loading composer repositories…”。

验证是否真走新源：