Composer报JSON错误90%是composer.json文件不合法，需用php -r或jsonlint.com定位非法字符（如末尾逗号、中文引号、BOM头），再按JSON规范修正；validate仅校验基础语法，加--strict才检查语义合法性。
Composer 报 JSON 错误，90% 是 composer.json 文件本身不合法，不是 Composer 坏了，也不用重装或清缓存——直接查文件。
composer validate 报错但没给行号？加 --verbose 或换 php -r 手动解析
默认 composer validate 有时只报 JSON parse error 却不指明位置，尤其在含 BOM、零宽字符或换行异常时。这时别猜，用 PHP 原生命令直击解析层：
-
php -r "$j=file_get_contents('composer.json'); $d=json_decode($j); if(!$d) echo json_last_error_msg()."\n";"—— 输出类似Parse error on line 12 at column 5，就盯住第 12 行前后 - Windows 用户注意：命令需用双引号包裹，内部双引号要转义，或改用 PowerShell
- 如果提示
Unexpected UTF-8 BOM或Invalid UTF-8 sequence，大概率是记事本保存的文件，用 VS Code 或 Notepad++ 转成 UTF-8 无 BOM 编码
哪些写法“看着像 JSON”但实际非法？
JSON 规范比人眼判断严格得多，以下写法在 composer.json 中一律失败：
- 末尾逗号：
"require": { "php": "^8.1", }❌（对象或数组最后一项后不能有逗号） - 单引号或中文引号：
'name': 'my/app'或“name”: “my/app”❌（必须英文双引号"name": "my/app"） - 键名没引号：
require: { php: "^8.1" }❌（require和php都必须加双引号） - 注释：
// dev only或/* skip */❌（JSON 标准不支持任何注释，粘贴临时标记也得删） - 反斜杠未转义：
"App\": "src/"❌（Windows 路径中的必须写成\或统一用正斜杠/）
validate 通过了，install 却崩？说明 schema 或值不合法
composer validate 默认只做基础校验：JSON 可解析 + 必填字段存在。它不管字段值对不对、路径存不存在、版本约束是否被支持。这类问题得靠 --strict：
-
composer validate --strict --no-check-publish—— 启用完整 schema 校验，比如报The property type is not defined and the definition does not allow additional properties就说明写了非法顶级键 -
"type": "lib"语法合法，但 schema 只认"library"、"project"等预定义值 →--strict才会拦 -
"autoload": {"psr-4": {"App": "src//"}}路径末尾双斜杠，JSON 合法，validate不报，但composer dump-autoload会警告目录不存在 -
"allow-plugins"字段只在 Composer 2.2+ 支持，老版本validate直接忽略，运行时静默失效
编辑器和 CI 怎么提前防住这些坑？
别等 composer install 在 CI 上崩了才修。本地和流水线都要前置拦截：
- VS Code 中打开
composer.json，右下角应显示JSON with Schema；若显示Plain Text，手动选择语言模式并配置json.schemas关联 https://www.php.cn/link/16543006525cbf0f74654bced183cffe - CI 脚本里加：
composer validate --no-interaction --strict，比只跑install --dry-run更早暴露字段级错误 - 临时排查可删减非核心字段（如
scripts、extra），再试validate，快速缩小范围 - Git 提交前用
git diff HEAD -- composer.json | grep -E '^[+-] *["''']'快速扫一遍引号和结构变动
真正难搞的从来不是语法错——而是 composer.json 语法合法、schema 合法、但某个字段值（比如 repositories.url 指向内网 GitLab 且 CI 不可达）让整个流程卡在元数据拉取阶段，连错误都报不全。
