composer validate 报错应先根据错误信息定位行号列号，检查末尾逗号、单引号、全角符号、键名引号缺失等 json 语法问题；再用 json_decode 快速验证纯语法；最后用 --strict 检查 schema 合法性。
composer validate 报错时，先看错误定位在哪一行
报错信息里通常会带行号和列号，比如 JSON parse error on line 12 at column 5，这说明问题在 composer.json 第 12 行第 5 列附近。别急着重写整个文件，先聚焦那一行。
常见诱因包括：
- 末尾多了一个逗号（尤其在最后一个数组项后），PHP 和 JSON 都不认这种写法
- 用了单引号代替双引号，JSON 只接受双引号包裹字符串
- 键名或字符串值里混入了中文全角符号（如“：”、“，”、“””）
-
require或autoload下的键值对格式错乱，比如把"psr-4"写成psr-4（漏掉引号）
用 json_decode() 快速验证 JSON 合法性
Composer 底层调用的就是 PHP 的 json_decode()，所以你可以直接用它做最小验证：
php -r "var_dump(json_decode(file_get_contents('composer.json'), true));"
如果返回 null，说明 JSON 解析失败；配合 json_last_error_msg() 能拿到更准的提示：
php -r "$j = file_get_contents('composer.json'); $d = json_decode($j); if (!$d) { echo json_last_error_msg()."\n"; }"
这个方法绕过 Composer 自身的 schema 校验，只测纯 JSON 语法，适合快速排除基础格式问题。
schema 不匹配导致的“语法正确但 validate 失败”
composer validate 不止检查 JSON 语法，还会对照 Composer 官方 schema 检查字段合法性。比如：
- 把
"type": "library"错写成"type": "lib"—— 值不在允许枚举中 - 在
autoload里写了"classmap": ["src/"]，但src/目录实际不存在 —— validate 默认不校验路径存在性，但加--no-check-all才跳过这类检查 -
minimum-stability写成了"dev"（正确是"dev"小写，但必须是预定义值之一）
遇到这种报错，建议运行：composer validate --strict，它会启用更完整的 schema 校验，并提示具体哪个字段不合法。
编辑器配置能提前拦住大部分低级错误
VS Code、PhpStorm 等主流编辑器默认识别 composer.json 并启用 JSON Schema 校验。确保你没关掉这个功能，否则光靠 composer validate 是事后补救。
关键点：
- 确认项目根目录下有
composer.json，且编辑器没把它当成普通文本打开（右下角应显示 “JSON with Schema”） - 如果提示 schema 未绑定，可手动在 VS Code 设置里添加：
"json.schemas"关联到https://json.schemastore.org/composer - 保存时自动格式化（Prettier 或内置 JSON formatter）能立刻暴露缩进错位、引号不闭合等问题
真正难搞的不是语法错误，而是 schema 允许但语义错误：比如 autoload 路径写对了，但 PSR-4 的命名空间映射漏了末尾反斜杠，或者 require-dev 里引用了还没发布的分支版本——这些 validate 不管，得靠 composer install 或 dump-autoload 才暴露。
