Composer报JSON decode error，100%是composer.json语法非法所致，因PHP json_decode()零容忍末尾逗号、单引号、注释、BOM等；应优先用php -r"json_decode(file_get_contents('composer.json'));"或jsonlint.com定位错误，validate不校验纯JSON语法。
Composer 报“JSON decode error”或“file could not be loaded”，几乎 100% 是 composer.json 本身语法不合法，不是网络、权限或缓存问题。
为什么一个逗号就让整个 install 失败
Composer 用 PHP 原生 json_decode() 解析 composer.json，而该函数对 JSON 格式零容忍：末尾多逗号、单引号代替双引号、行内注释、未闭合的字符串、Unicode 转义错误、BOM 头——任一都会直接中断执行。
常见错误现象：
JSON decode error: Syntax errorfile could not be loaded-
Unexpected token（后面跟着某一行号）
别信 php -l composer.json —— 它只检查 PHP 语法，对 JSON 无效。正确验证方式只有两个：
- 终端运行：
php -r "json_decode(file_get_contents('composer.json'));" && echo 'OK' || echo 'Invalid JSON' - 把内容粘贴到 jsonlint.com，它会标出具体哪一行、哪个字符出错
VS Code 里怎么一眼看出问题
很多问题其实在编辑器里就能提前发现，前提是配置正确：
- 右下角状态栏确认语言模式是
JSON，不是JSON with Comments（后者允许//注释，但 Composer 不认） - 确保没有红色波浪线 —— VS Code 的 JSON 验证器和
json_decode()规则一致 - 禁用所有可能自动加尾逗号的插件（如 Prettier 默认开启
trailingComma） - 保存前手动检查：是否误用了中文引号、全角空格、不可见控制字符（尤其从网页复制配置时）
validate 命令通过 ≠ JSON 合法
composer validate 只校验 JSON 结构 + 基本 schema（比如 name 字段格式、必需字段是否存在），它完全不调用 json_decode() 做底层解析。
也就是说：
-
composer validate通过，但composer install仍报 JSON error → 一定是 JSON 语法非法，validate 没测到 -
composer validate失败，但错误提示是 “name is required” 或 “license must be a string” → 这是 schema 错，不是语法错，json_decode()其实能过
真正可靠的 JSON 合法性测试，永远只依赖 json_decode() 本身，而不是任何 Composer 子命令。
改完 JSON 还卡在 autoload 或 Class not found
修复了 JSON 格式后，composer install 却卡住、或后续报 Class not found，大概率是旧状态残留：
- 删掉
vendor/和composer.lock（除非你明确要保留 lock） - 运行
composer clear-cache，清掉可能损坏的本地包缓存 - 加
--no-cache参数重装：composer install --no-cache - 如果涉及
autoload修改（比如新增了psr-4映射），必须额外跑一次composer dump-autoload
最常被忽略的一点：Composer 不会因 composer.json 变更而自动重建 autoloader；哪怕只是改了命名空间路径，不 dump-autoload，类就永远加载不到。
