composer报invalid json错时，90%因语法错误，可用php -r命令精确定位错误位置，并配合编辑器json验证、在线工具或插件快速修复。
Composer 报错 Invalid JSON 时，90% 是因为 composer.json 文件里多了个逗号、少了个引号，或者用了中文标点——它不报具体哪一行，但问题一定出在 JSON 语法上。
怎么看是哪个字符错了？别靠肉眼扫
Composer 自身不输出详细语法错误位置，直接用 PHP 内置的 JSON 解析器定位最准：
php -r "json_decode(file_get_contents('composer.json')); echo json_last_error_msg();"
执行后会返回类似 Syntax error 或更具体的 Unexpected character。配合 VS Code / PHPStorm 的 JSON 验证（保存时自动标红）、或粘贴到 jsonlint.com 这类在线工具里，能立刻高亮错误行和列。
- 注意：Windows 下路径含空格时，命令需加双引号包裹文件名
- 如果提示
Control character error，大概率是复制粘贴时混入了不可见的 Unicode 控制符（比如 Word 里粘过来的换行） - VS Code 用户可安装 “JSON Tools” 插件，右键选 “Prettify JSON” —— 格式化失败即暴露语法问题
哪些“看起来正常”的写法 Composer 会拒绝？
JSON 规范比 PHP 数组严格得多，以下写法在 composer.json 中全都不合法：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 对象末尾多一个逗号：
"require": { "php": "^8.1", }→ 必须删掉逗号 - 键或字符串值用了单引号：
'name': 'my/app'→ 必须用双引号 - 注释：
// 这是注释或/* 也是非法的 */→ JSON 不支持任何注释 - 尾部换行缺失（极少数旧版解析器敏感）→ 确保文件以
\n结尾
特别注意：某些 IDE 默认把缩进设为 Tab，而 JSON 规范允许空格或 Tab，但 Composer 底层用的 json_decode() 在部分 PHP 版本中对 Tab 处理不稳定，统一用 2 或 4 个空格更稳妥。
修复后仍报错？检查隐藏的 BOM 和编码
Windows 记事本保存的 UTF-8 文件常带 BOM（Byte Order Mark），PHP 解析 JSON 时会把它当开头字符，直接导致 Unexpected token。
- 用 VS Code 打开
composer.json，右下角看编码显示 —— 如果是UTF-8 with BOM，点击切换成UTF-8并保存 - 命令行快速检测：
head -c 3 composer.json | xxd，若输出含ef bb bf就是 BOM - Linux/macOS 可用：
sed -i '1s/^\xEF\xBB\xBF//' composer.json（GNU sed）或gsed -i '1s/^\xEF\xBB\xBF//' composer.json（macOS Homebrew 安装的 sed）
真正麻烦的不是语法错误本身，而是错误信息不指明位置，加上开发环境里编辑器自动补全、复制粘贴、Git 换行符转换这些“隐形操作”，都可能悄悄污染 JSON。修完记得 composer validate 跑一遍，它比 install 更轻量，也更早暴露问题。
