Composer install 报 JSON parser error 时应先查看报错行号列号，用支持 JSON 高亮的编辑器定位问题，检查逗号、引号、注释、BOM 和换行符等非法格式，并通过 composer validate --strict 提前校验。
composer install 报错 JSON parser error 怎么快速定位
直接看报错末尾的行号和列号，比如 Parse error: JSON parser error in composer.json at line 12, column 15 —— 这说明问题就在第 12 行第 15 列附近，不是整个文件都坏了。
- 用支持 JSON 高亮的编辑器（如 VS Code、Sublime）打开
composer.json，跳转到对应行，重点检查：逗号遗漏、多了一个逗号、单引号代替双引号、注释（JSON 不允许//或/* */）、尾部多余逗号（尤其在对象最后一个字段或数组最后一项后） - 别手动删空格或换行来“修复”，JSON 对空白不敏感，但对标点极其敏感；真正要盯的是
{ }、[ ]、" "和逗号的位置 - 可以用在线校验工具（如 jsonlint.com）粘贴内容验证，但注意别传含敏感信息（如私有仓库配置）的完整文件
哪些写法看起来正常，但实际会触发 JSON parser error
JSON 标准很严格，很多 PHP 数组写法或手写习惯在 composer.json 里是非法的。
-
"require": { "php": "^8.1", }—— 末尾逗号（trailing comma）在 JSON 中非法，PHP 数组允许，但这里不行 -
"version": '1.0.0'—— 单引号包裹字符串，JSON 只认双引号 -
"description": "A demo package // this is a comment"—— 注释不能出现在 JSON 值里 -
"autoload": { "psr-4": { "App\": "src/" } }—— 缺少逗号分隔其他字段（如后面还有"autoload-dev"），容易漏
用 composer validate 提前发现语法问题
这个命令不装包、不联网，只做本地 JSON 结构 + Composer Schema 校验，比等 install 失败再修快得多。
- 运行
composer validate --strict，它会检查 JSON 合法性 + 字段名是否拼错（比如把require-dev写成requires-dev） - CI/CD 流程里建议加这步，避免因格式问题阻塞构建
- 如果提示
The property xxx is not defined and the definition does not allow additional properties，说明用了 Composer 不认识的 key，比如误写了scripts-dev而不是scripts
Windows 下换行符或 BOM 导致解析失败
某些编辑器（尤其是老版本 Notepad）保存时会加 UTF-8 BOM 或用
混合换行，Composer 在部分环境（如 Docker 容器内）会因此解析失败，错误可能不报具体行列，只说 Unexpected token。
- 用 VS Code 打开
composer.json，右下角查看编码格式，确保是UTF-8（不是UTF-8 with BOM） - 在命令行执行
file composer.json（Linux/macOS）或Get-Content composer.json -Encoding Byte | Select -First 3（PowerShell）确认前几个字节不是EF BB BF - 换行统一用
.gitattributes：* text=auto eol=lf
实际改完别急着重跑 install，先 composer validate 过了再继续——很多所谓“网络问题”或“权限问题”，其实是 JSON 从第一行就崩了，只是报错信息藏得深。
