Composer报错JSON语法错误时，可用php -r命令或check-json.php脚本快速定位错误行号与列位置，因JSON标准不支持注释，需检查逗号、引号、括号等符号是否匹配。
Composer 报错 json 文件语法错误，基本就是 composer.json 里某个逗号、引号、括号没写对，或者用了注释——JSON 标准根本不支持注释。
用 json_decode() 快速定位错误行
PHP 自带的 json_decode() 能直接告诉你错在哪一行哪一列，比反复看文件高效得多：
php -r "json_decode(file_get_contents('composer.json')) or die('JSON error: '.json_last_error_msg().' at line '.(substr_count(file_get_contents('composer.json'), "
") + 1)."
");"更实用的是加个行号标记版本（保存为 check-json.php）：
<?php
$content = file_get_contents('composer.json');
$result = json_decode($content, true);
if ($result === null) {
$error = json_last_error();
$line = 1;
$pos = json_last_error_msg();
$lines = explode("
", $content);
foreach ($lines as $i => $l) {
if (strpos($content, $l) !== false && strlen(substr($content, 0, strpos($content, $l))) <= json_last_error_msg()) {
$line = $i + 1;
break;
}
}
echo "JSON parse error on line $line: " . json_last_error_msg() . "
";
exit(1);
}运行 php check-json.php 就能精准定位。常见报错如 syntax error, unexpected '}' 或 Unexpected token 都对应具体位置。
Composer 自带校验命令：composer validate
这个命令不只是检查 JSON 语法，还会验证字段合法性（比如 require 是否是对象、autoload 是否结构合规），但默认不显示详细位置：
- 加
-v参数可看到更多上下文：composer validate -v - 加
--no-check-all跳过远程包检查，提速；只查本地格式用composer validate --no-check-publish - CI/CD 中建议加
--strict：把警告当错误（比如缺少description字段）
注意：composer validate 不会报出“多了一个逗号”这种低级错误的具体位置，它依赖底层 JSON 解析器，所以仍需配合 json_decode() 定位。
编辑器和 IDE 的实时校验陷阱
VS Code、PHPStorm 等通常能高亮 JSON 错误，但有三个容易忽略的坑：
- 文件编码不是 UTF-8 无 BOM：Windows 记事本保存的
composer.json常带 BOM，导致json_decode()直接失败，报Unexpected character - 用了单引号：JSON 只认双引号，
'name': 'foo'是非法的，必须写成"name": "foo" - 末尾多逗号：虽然某些解析器容忍，但标准 JSON 不允许对象或数组最后一项后跟逗号，
{"a":1,}是错的
推荐在 VS Code 中安装 JSON Tools 插件，右键菜单点 JSON: Validate，它会调用本地 node 解析器，反馈比 PHP 更直观。
常见错误模式与修复对照
以下这些写法在 composer.json 中高频出错：
-
"require": { "php": "^8.1", }→ 删除末尾逗号 -
"autoload": { 'psr-4': { "App\": "src/" } }→ 单引号全换成双引号 -
// 注释说明或/* 这里是注释 */→ JSON 不支持任何注释，删掉 -
"version": "1.0.0-beta"放在根对象里 →version字段只在 package 发布时由 Packagist 解析，本地composer.json中应删除 - 中文路径或空格没转义：如
"files": ["lib/工具函数.php"]→ 改成"files": ["lib/\u5de5\u5177\u51fd\u6570.php"]或（更推荐）避免中文路径
最省事的办法：从 https://www.php.cn/link/2bfd7c7985715037980235d588dc2e9e 复制最新空模板，再往里填内容，比修烂文件快得多。
