composer报json解析失败，90%是composer.json本身不合法；应运行php -r命令或jsonlint.com定位错误行，检查末尾逗号、中文引号、bom、注释等，并清理vendor、lock及缓存后重装。
Composer 报 JSON 解析失败，90% 是 composer.json 文件本身不合法，不是 Composer 坏了，也不是网络或权限问题——删 vendor、重装 Composer、换源都没用，必须修文件。
怎么快速定位哪一行出错
Composer 自己不报具体行列，但 PHP 的 json_decode() 会。终端直接运行：
php -r "$j = file_get_contents('composer.json'); $d = json_decode($j); if (!$d) { echo json_last_error_msg()."\n"; }"
输出类似 Parse error on line 12 at column 5，就说明第 12 行第 5 列附近有问题。常见诱因包括：
- 末尾多一个逗号（
"require": { "foo/bar": "^1.0", }❌） - 用了中文引号或单引号（
“name”: “my/app”或'name': 'my/app'❌） - 键名没加双引号（
name: "my/app"❌，必须是"name": "my/app"✅） - 文件开头有 UTF-8 BOM（Windows 记事本保存极易引入）
- 写了
// 注释或/* */—— JSON 标准不支持任何注释
用什么工具验证最靠谱
别信 IDE 的“格式化”按钮，它可能把错误“美化”得更难排查。优先闭环验证：
- 粘贴内容到 jsonlint.com：高亮错误、自动标出行列、还能一键格式化
- VS Code 打开后确认右下角显示的是
JSON（不是Plain Text或JSON with Comments），红色波浪线处就是语法破绽 - 终端跑
python3 -m json.tool composer.json > /dev/null（macOS/Linux 自带；Windows 装 Python 即可）：报错直接带行号，比如Expecting property name enclosed in double quotes
php -l composer.json 没用——它只检查 PHP 语法，对 JSON 完全无效。
为什么 composer validate 不报错但 install 还失败
composer validate 只校验 JSON 结构 + 基础 schema（比如 name 是否存在、格式是否为 vendor/name），不校验字段值是否合法。典型漏检场景：
-
"version": "dev-main"：validate 通过，但 install 时解析版本约束失败，报Invalid version string -
"repositories": [{ "type": "gitlab", "url": "" }]：拼错type（应为"vcs"），validate 不报，install 却卡住 -
"autoload": { "psr-4": { "App": "src//" } }：路径末尾多斜杠，validate 不管，dump-autoload会警告路径不存在 -
"config": { "allow-plugins": { } }：该字段仅 Composer 2.2+ 支持，老版本 validate 不识别，但运行时报错
修复后 install 还卡在 autoload 或报 Class not found
JSON 修复了，但旧缓存或生成文件没清理干净，Composer 不会自动感知结构变更，尤其涉及 autoload 或 repositories。安全清理步骤：
- 删掉
vendor/目录和composer.lock（除非你明确要保留 lock 文件） - 运行
composer clear-cache，避免本地 repo 缓存干扰 - 再执行
composer install --no-cache，跳过可能损坏的缓存层 - 如果仍报
Class XXX not found，检查composer dump-autoload -o输出，确认它是否真读到了你改过的autoload配置
真正容易被忽略的是：Git 合并冲突后手动删了 但没清空空行或缩进错位，<code>composer.lock 的 content-hash 会校验失败，导致静默装错包——这种时候只能 composer update --lock 重建。
