Composer 报 JSON syntax error 时，90% 是 composer.json 文件本身不符合 JSON 规范，应直接校验文件；可用 php -r 命令或 jsonlint.com 定位非法字符（如末尾逗号、单引号、注释、BOM 头），再用 composer validate --strict 检查语义错误，并通过编辑器 JSON Schema 支持预防问题。
Composer 报 JSON syntax error 时，90% 是 composer.json 文件本身不符合 JSON 规范，不是 Composer 本身出问题 —— 直接校验文件，别绕路。
用 json_decode() 或在线工具快速验证语法
本地 PHP 环境下，一行命令就能暴露错误位置：
php -r "json_decode(file_get_contents('composer.json')) || die('JSON error: '.json_last_error_msg());"
输出类似 JSON error: Syntax error 说明有非法字符；若带行号（如 PHP 8.0+），会提示更精确位置。更稳妥的做法是复制内容粘贴到 jsonlint.com —— 它能标出具体哪一行哪个字符违规（比如末尾多逗号、单引号代替双引号、中文标点、BOM 头）。
常见非法格式：逗号、引号、注释、BOM
JSON 不允许这些写法，但开发者常误用：
-
"require": { "php": "^8.1", }→ 末尾逗号（,）在对象或数组最后是非法的 -
'monolog/monolog': '^3.0'→ 单引号（'）必须全换成双引号（"） -
// 注释这行会被当成字符串值→ JSON 标准不支持注释，删掉 - 用 Windows 记事本保存 → 可能带 UTF-8 BOM 头，导致
composer install报错JSON decode error: Syntax error，用 VS Code 或 Notepad++ 以“UTF-8 无 BOM”重新保存
composer validate 能发现更多语义错误
composer validate 不只查语法，还校验字段合法性（比如 type 是否合法、autoload 结构是否完整）：
- 运行
composer validate --strict启用严格模式，会警告未声明的顶级字段（如手误写了"autoloader"而非"autoload"） - 如果报
The property name is required，说明根对象缺"name"字段（私有包可设为"private": true并省略name，但需显式声明） - 字段值类型错也会报错，例如把
"minimum-stability": "stable"写成"minimum-stability": true
编辑器配置能预防大部分问题
VS Code / PHPStorm 默认对 composer.json 有 JSON Schema 支持，但需确认开启：
- 确保文件关联了 JSON 语言模式（右下角显示 “JSON”，不是 “Plain Text”）
- 安装插件如 “JSON Tools” 或启用内置 JSON 验证（Settings → Text Editor → JSON → Schema Validation）
- 输入时自动补全字段名、实时标红语法错误，比等
composer install失败再修快得多
真正麻烦的不是语法错，而是改完一个错又冒出另一个——比如修复了逗号，结果发现缩进里混了 tab 和空格，某些解析器会把 tab 当作非法字符。用统一空格（2 或 4）、关掉自动插入 tab，比反复跑 validate 更省时间。
