Composer报错时直接显示JSON解析失败的精确行列位置，如“line 15”和“^”所指处；常见错误包括末尾逗号、单引号、注释、未引号键名及未转义字符；BOM头会导致静默解析失败，需用hexdump排查并清除。
Composer 报错时直接显示 JSON 解析失败位置
Composer 本身不内置 JSON 格式校验器，它依赖 PHP 的 json_decode() 函数解析 composer.json。一旦 JSON 语法非法，PHP 会抛出异常，Composer 捕获后输出带行号和列号的错误提示——这是定位问题最直接的线索。
常见报错格式类似：
./composer.json:12:18: syntax error, unexpected ','
或更详细的：
[Seld\JsonLint\ParsingException]
"./composer.json" does not contain valid JSON
Parse error on line 15:
... "require": { "php": "^8.1",
---------------------^
Expected one of: 'STRING', 'NUMBER', 'NULL', 'TRUE', 'FALSE', '{', '['注意：行号和列号（如 line 15、^ 所指位置）是真实依据，不是估算值。
典型 JSON 语法错误及对应提示特征
以下错误在 composer.json 中高频出现，各自触发的提示有明显差异：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 末尾多逗号（trailing comma）：PHP 7.4+ 会报
syntax error, unexpected ','，位置指向多余逗号所在行；PHP 7.3 及更早版本直接报Unexpected token , - 单引号代替双引号：
json_decode()严格要求双引号，用单引号会导致Unexpected token '或整段解析失败，提示常卡在第一行 - 注释（// 或 /* */）：JSON 不支持注释，任何注释都会让解析器在注释起始处崩溃，提示类似
Unexpected token / - 键名未加引号：如
require: { php: "^8.1" }→ 报Unexpected token r（因为解析器期待"require"而不是require） - 字符串内含未转义的换行或双引号：提示指向该字符串开头，错误类型为
Unterminated string或Invalid character
验证 JSON 语法的最快方式（不依赖 Composer）
与其反复运行 composer install 看报错，不如先用轻量工具预检：
- 命令行用
php -l composer.json：仅检查 PHP 语法（对 JSON 文件无效，慎用） - 正确做法是：
php -r "json_decode(file_get_contents('composer.json')); echo json_last_error_msg();"—— 输出No error表示合法 - 或使用系统级工具：
jq -n -f composer.json >/dev/null && echo ok || echo invalid（需已安装jq） - 编辑器层面：VS Code 安装 “JSON” 官方扩展后，保存时自动标红语法错误，光标悬停即显示具体原因
容易被忽略的隐藏问题：BOM 和不可见字符
某些编辑器（尤其 Windows 下的记事本、旧版 Sublime）可能在文件开头写入 UTF-8 BOM（\xEF\xBB\xBF），导致 json_decode() 直接返回 null，错误信息却只显示 Syntax error，不提示位置。
排查方法：
- 用
hexdump -C composer.json | head查看前几字节，若输出以ef bb bf开头，说明存在 BOM - 用
sed -i '1s/^\xEF\xBB\xBF//' composer.json（Linux/macOS）或iconv -f UTF-8 -t UTF-8//IGNORE composer.json > tmp.json && mv tmp.json composer.json清除 - 另存为“UTF-8 无 BOM”格式（VS Code 底部状态栏点击编码 → “Save with Encoding” → “UTF-8”）
BOM 问题不会出现在大多数现代编辑器中，但一旦出现，它会让所有 JSON 工具静默失败，且错误提示毫无指向性——这是最耗时间的隐形坑。
