composer提示invalid character in json怎么办_composer.json语法错误纠正【汇总】

jsON报invalid character错误90%因全角引号、bom、中文标点或注释；须用半角英文引号”、UTF-8无BOM编码、删注释，并用composer validate定位具体行列。

检查 json 中的中文引号和不可见字符

Composer 报 invalid character in json，90% 是因为用了全角引号（“”）、中文顿号、空格或复制粘贴带 BOM 的文本。JSON 只认 ASCII 引号 "，不接受 “ 或 ”，也不接受 windows 记事本保存的 UTF-8+BOM。

• 用 VS Code、sublime 或 vim 打开 composer.json，确认所有引号都是英文半角双引号 "
• 在 VS Code 中右下角查看编码格式，如果不是 UTF-8（无 BOM），点击切换并重新保存
• 终端执行 file -i composer.json（linux/macos）或 Get-Content composer.json -Encoding UTF8 | format-Hex（PowerShell）排查隐藏字符
• 临时重写最简配置验证：用

  {"name":"test/test","require":{}}

  替换原文件内容，再逐步加字段

验证 JSON 结构是否合法（逗号、括号、冒号）

JSON 对标点极其敏感：末尾多逗号、缺冒号、括号不闭合都会触发该错误。尤其容易在 require 或 autoload 块中手误。

• 运行 php -l composer.json 无法检测 JSON 语法，要用 json_decode(file_get_contents('composer.json'), true) === NULL 测试，或直接用在线工具如 jsonlint.com
• 常见错误示例：

  {"require": {"monolog/monolog": "^2.0",}}

  —— 末尾逗号非法

• {"autoload": {"psr-4": {"app\": "src/"}}}

  缺少 , 后续字段时易漏掉前面的闭合

• 嵌套对象里混用单引号（'App\'）会导致解析失败，JSON 不支持单引号

注意 Composer 特定字段的格式限制

有些字段看似是字符串，实则要求严格格式，比如 version、license、autoload 的键名，填错会间接导致 JSON 解析器读到非法 Token。

• version 字段值必须是字符串，不能写成 1.0.0（无引号），否则 JSON 解析为数字，Composer 会拒绝
• license 必须是字符串或字符串数组，写成 MIT（无引号）是非法 JSON
• autoload 下的 psr-4 键必须是命名空间字符串结尾带反斜杠，如 "App\"，少一个 会被当成转义错误
• 注释不是 JSON 标准语法，// 或 /* */ 会直接报 invalid character，删掉所有注释再试

用 composer validate 快速定位问题行

composer validate 不仅校验 JSON 语法，还检查 Composer Schema 合法性，且会提示具体出错位置（行号+列号），比纯 JSON 解析更实用。

• 运行 composer validate --no-check-publish --no-check-all 跳过网络校验，聚焦本地语法
• 输出类似 [SeldJsonLintParsingException] "./composer.json" does not contain valid JSON Parse Error on line 12 at column 17: syntax error, unexpected ','，立刻去第 12 行看第 17 列前后
• 如果提示 requires a non-empty String，说明某字段值为空字符串或 null，JSON 允许 "key": ""，但 Composer 某些字段禁止空值（如 name）
• 某些 ide 插件（如 phpstorm 的 JSON 支持）能实时高亮语法错误，开启后编辑时就能避坑

真正卡住的时候，不要逐行肉眼扫——先用 composer validate 定位行号，再用编辑器显示不可见字符（VS Code 按 Ctrl+Shift+P → “Toggle Render Whitespace”），最后只保留最小可运行结构逐步扩展。JSON 错误的表象千奇百怪，根源往往就藏在那一个引号、一个逗号或一个没转义的反斜杠里。