php -r 直接调用 PHP 原生 JSON 解析器，可精准定位到字节级错误；composer validate 仅做语义校验，因跳过 BOM、忽略全角符号等导致行号失真，无法准确定位语法错误。
直接用 php -r 解析是最准的，composer validate 报错位置常被误导，尤其当文件带 BOM、全角符号或末尾逗号时。
为什么 composer validate 定位不准
它内部调用 JSON 解析器的方式会掩盖真实错误点。比如报 JSON parse error on line 12 at column 5，但实际问题可能在第 11 行末尾多了一个逗号，或第 10 行混入了零宽空格（U+200B）。Composer 还会跳过 BOM 头导致整段解析偏移，使行号完全失真。
- 错误信息里的行号是解析器“认为”的位置，不是编辑器光标所在处
- VS Code 右下角显示 “UTF-8 with BOM” 就必须重存为纯 UTF-8
- 从网页复制的
:很可能是全角冒号，cat -A composer.json | head -n 15能暴露隐藏字符
用 php -r 精准定位语法错误
这行命令绕过 Composer 层，直击 PHP 原生 JSON 解析器，错误信息明确到字节级：
php -r "$j = file_get_contents('composer.json'); $d = json_decode($j); if (!$d) { echo 'JSON error: ' . json_last_error_msg() . "\n"; }"
- 输出如
JSON error: Syntax error→ 检查最后一项后是否多逗号 - 输出如
JSON error: Unexpected character→ 查该行附近中文引号、全角符号、BOM - 输出如
JSON error: Malformed UTF-8 characters→ 文件含 BOM 或编码不一致
哪些符号和格式最容易翻车
不是所有“看着像 JSON”的内容 Composer 都认。以下写法在 composer.json 中一律非法：
- 单引号：
'name': 'myorg/myapp'❌，必须双引号："name": "myorg/myapp" - 注释：
// description或/* ... */全部不支持，粘贴前务必删干净 - 路径末尾斜杠：
"url": "../my-pkg/"会被 Composer 完全忽略该仓库 - repositories 数组最后一项带逗号：
{"type": "path", "url": "../pkg"},❌
composer validate 的正确用法
它只适合语义校验，不是语法诊断工具。真正要用它，必须加两个关键参数：
-
--strict：把拼错字段（如autoloader应为autoload）、废弃值（如"minimum-stability": "dev-master"）转为硬性错误 -
--no-check-publish：跳过 Packagist 网络请求，避免 DNS 或防火墙干扰 CI 流程 - 完整命令：
composer validate --strict --no-check-publish
注意：这个命令不会告诉你 JSON 语法错在哪，只负责字段合法性。语法问题永远优先交给 php -r。
