composer 的 composer.json 报 json 语法错误，90% 是因标点、引号或结构不合法；运行 composer validate 可定位错误行，常见问题包括中文引号、末尾逗号、注释及 bom 头。
直接说结论：Composer 的 composer.json 报 JSON 语法错误，90% 是因为标点、引号或结构不合法——不是 Composer 本身有问题，而是文件被手改坏了。
怎么看具体哪行错了？
运行 composer validate，它会明确指出错误位置（比如第 5 行末尾缺少逗号、第 12 行用了中文引号）。别跳过这步，盲目改容易越修越错。
常见报错示例：JSON decoding failed: Syntax error、Unexpected token }、Expected ',' or '}' after property value in object。
- 错误行数不一定精准（尤其含注释或换行异常时），但方向基本可靠
- 如果提示“invalid UTF-8 sequence”，大概率是复制粘贴进去了不可见字符（如零宽空格）
- Windows 记事本保存的
composer.json常带 BOM 头，也会触发解析失败
哪些地方最容易出错？
JSON 对格式极其敏感，以下几处高频翻车：
-
"require"或"autoload"后面的{必须独占一行或紧跟冒号，不能写成"require": {后直接跟换行又没缩进（虽合法，但易引发编辑器误判） - 所有键和字符串值必须用英文双引号
"，绝不能用单引号'或中文引号“” - 对象最后一项后面不能加逗号（
"php": "^8.1",→ 错；"php": "^8.1"→ 对） - 数组里混入注释（JSON 标准不支持
//或/* */），哪怕只是临时标记也得删掉
怎么安全修复并验证？
别在原文件上硬改。推荐三步走：
- 把当前
composer.json内容粘贴到在线 JSON 验证器（如 jsonlint.com），它会高亮错误并自动格式化——这是最省力的定位方式 - 修复后，用
composer validate --no-check-publish本地验证（跳过 Packagist 兼容性检查，专注语法） - 确认通过后，再运行
composer install或composer update，避免因依赖字段格式问题导致后续命令中断
如果项目已提交 Git，可先 git checkout -- composer.json 回退到上一版，再对比差异找改动点。
编辑器和保存方式的影响
VS Code、PHPStorm 默认对 JSON 友好，但记事本、WPS、某些网页编辑器会偷偷插入非标准字符或编码。
- 务必用 UTF-8 无 BOM 编码保存（VS Code 右下角点击编码名可切换）
- 禁用「自动添加结尾换行」以外的任何自动格式化插件，尤其避免 JSON Beautifier 类插件在保存时擅自重排结构
- 新增依赖建议用
composer require vendor/package自动生成条目，而不是手动写进composer.json
一个被忽略的细节：Windows 路径分隔符 在 autoload 的 "psr-4" 映射里必须写成正斜杠 / 或双反斜杠 \，否则 JSON 解析可能不报错但 autoload 失效。
