composer install 报错 JSON decode error 是因 composer.json 文件存在语法错误，如多余逗号、缺失引号、单引号、注释、BOM 或隐藏字符等，需用 php -r 验证或工具修复。
composer install 报错 JSON decode error: Syntax error
这是 composer 读取 composer.json 时发现 JSON 格式不合法，直接拒绝继续。不是网络或权限问题，而是文件本身写坏了——哪怕只多一个逗号、少一个引号，都会触发这个错误。
常见错误现象：composer install 或 composer update 立即退出，报错里明确带 JSON decode error，并可能附上行号（但不可全信，JSON 解析器定位常偏移）。
- 手动编辑过
composer.json：比如改了包名、加了注释、用了单引号、末尾多逗号 - 从网页复制内容粘贴进去：混入了不可见的 Unicode 字符（如零宽空格、中文标点）
- 用记事本或某些 IDE 自动保存为 UTF-8 with BOM 编码
用 jsonlint 或 PHP 命令行快速验证 JSON 合法性
别靠眼睛找括号配对，用工具秒判。本地没装 jsonlint？PHP 自带的 json_decode() 就够用。
实操建议：
- 运行
php -r "var_dump(json_decode(file_get_contents('composer.json'), true));"—— 输出NULL即非法，同时会打印具体错误（如Unexpected character） - 或者用在线工具（如 jsonlint.com），但注意别传含敏感信息的完整文件；仅粘贴疑似出问题的片段
- 重点检查：所有字符串必须用双引号；对象末尾不能有逗号；不能出现
//或/* */注释；true/false/null小写且无引号
composer.json 中易错的字段和值写法
很多错误不是语法级的，而是 composer 特定字段的约定被打破，导致解析中途失败或后续报错伪装成 JSON 错误。
-
"name"和"description"必须是字符串，不能为空或null -
"require"和"autoload"必须是对象（{}），不能是数组（[]）或缺失 - 版本约束写成
"^1.2.3"没问题，但写成"~1.2"且后面跟了空格或换行，可能被某些解析器截断 - 路径类字段如
"vendor-dir"的值不能含 Windows 风格反斜杠\，应统一用/
修复后仍报错？检查 BOM 和隐藏字符
编辑器显示正常，但文件开头藏了个 U+FEFF（BOM），PHP 会把它当普通字符塞进 JSON 字符串开头，直接让整个 JSON 失效。
怎么确认？
- 用
hexdump -C composer.json | head -n 1（Linux/macOS），看前几个字节是不是ef bb bf - 用 VS Code 打开，右下角查看编码，如果是
UTF-8 with BOM，点击切换为UTF-8并保存 - 用
sed -i '1s/^\xEF\xBB\xBF//' composer.json（Linux/macOS）或在 PowerShell 中用(Get-Content composer.json -Raw) -replace "\uFEFF", "" | Set-Content composer.json
真正麻烦的往往不是语法，而是那些看不见的字符——改完记得用上面的 PHP 命令再验一次，别信编辑器的“看起来没问题”。
