composer.json语法错误会导致composer install/update报JSON解析失败等错，应先运行composer validate校验，再用python -m json.tool定位行号，常见问题包括name格式不符、psr-4路径缺斜杠、scripts值类型错误等。
composer.json 文件语法错误会导致什么
执行 composer install 或 composer update 时突然报错，但没改过依赖，大概率是 composer.json 格式不合法。常见现象包括：JSON decode error: Syntax error、Invalid argument supplied for foreach()（实际是解析失败后数组为 null）、或命令卡住无响应（某些旧版 Composer 会静默失败）。这类问题不报具体行号，排查成本高。
用 composer validate 命令做基础校验
composer validate 是最直接的内置校验方式，它检查 JSON 语法 + Composer 特定 schema 规则（如 name 必须含斜杠、version 不能是 dev-master 等）。默认只校验当前目录的 composer.json：
composer validate
常用参数：
-
--no-check-all：跳过对所有依赖包composer.json的递归校验（省时，本地开发够用） -
--strict：启用严格模式，把警告（如未声明type）也当错误处理 -
--no-check-lock：不校验composer.lock是否与composer.json同步（CI 中常禁用，避免因 lock 文件滞后误报）
JSON 语法本身出错，validate 不报行号怎么办
composer validate 不输出错误位置，纯 JSON 语法问题建议绕过 Composer 直接验证：
- 用系统级工具：
python -m json.tool composer.json（Python 自带，报错带行号） - 用 Node.js：
npx jsonc-parser --validate composer.json（支持 JSONC 注释） - 编辑器里打开
composer.json，VS Code 默认带 JSON 验证，错误会标红并提示位置
注意：Composer 允许 JSON5 风格的注释（// 和 /* */），但原生 json.tool 不支持，此时需用 jsonc-parser 或在线 JSONC 验证器。
schema 校验失败的典型场景和修复
即使 JSON 语法正确，composer validate 仍可能报错，常见于：
-
name字段缺失或格式错误（必须为vendor/package形式，不能是myproject） -
autoload中psr-4映射路径末尾漏掉/（如写成"App\": "src/App"而非"App\": "src/App/"） -
require里用了未发布的版本约束（如"monolog/monolog": "dev-feature-branch"，除非该分支在repositories中明确定义） -
config下写了 Composer 不识别的键（如误写"cache-dir"应为"cache-dir"—— 实际这个是对的，但类似"cache_path"就非法）
校验通过不等于能正常安装，只是说明配置符合 Composer 官方 schema；真正运行时还受网络、权限、PHP 版本限制影响。
最容易被忽略的是：composer.json 中的 scripts 字段值必须是字符串或数组，若写成对象（如 "post-install-cmd": { "MyClass::method" }）会导致 validate 通过但后续执行脚本时报错。
