快速定位composer.json JSON错误：运行php -r "$j=file_get_contents('composer.json');$d=json_decode($j);if(!$d)echo json_last_error_msg();"`，输出如“Parse error on line 12”即指第12行附近存在末尾逗号、中文引号、BOM或注释等非法字符。
composer.json 格式报错，90% 是文件本身不合法 JSON，不是 Composer 问题，别折腾 vendor 或重装 Composer。
怎么快速定位哪一行出错
Composer 不会告诉你具体字符位置，但
可以。直接在终端运行：
输出类似
就说明第 12 行第 5 列附近有问题。常见诱因包括：
末尾多一个逗号（
❌）
用了中文引号或单引号（
❌，必须是
✅）
键名没加双引号（
❌）
文件开头有不可见的 UTF-8 BOM（Windows 记事本保存极易引入）
写了
或
—— JSON 标准不支持任何注释
用什么工具验证最靠谱
别依赖 IDE 的“格式化”功能，它可能把错误“美化”得更难排查。优先用这些方式闭环验证：
粘贴内容到
jsonlint.com
：高亮错误、自动标出行列、还能一键格式化
VS Code 打开后确认右下角显示的是
（不是
或
），红色波浪线处就是语法破绽
终端跑
（macOS/Linux 自带；Windows 装 Python 即可）：报错直接带行号，比如
注意：
没用——它只检查 PHP 语法，对 JSON 完全无效。
php版微信js-sdk支付接口类
php版微信js-sdk支付接口类
下载
为什么
有时不报错但
还失败
只校验 JSON 结构 + 基础 schema（比如
是否存在、格式是否为
），**不校验字段值是否合法**。典型漏检场景：
：validate 通过，但 install 时解析版本约束失败，报
：拼错
（应为
），validate 不报，install 却卡住
：路径末尾多斜杠，validate 不管，
会警告路径不存在
：该字段仅 Composer 2.2+ 支持，老版本 validate 不认识也不报错，但实际运行会忽略或报错
所以 CI 流程里不能只跑
，得加
模拟真实依赖解析。
修复后还报错？别忘了清理残留
JSON 修好了，
却仍失败，大概率是旧缓存或 lock 文件污染：
删掉
目录和
（除非你明确要保留 lock）
清缓存：
，或手动删
重装时加
：避免读取损坏的缓存层，
如果改了
，务必再跑一次
，并检查它的输出是否真加载了新配置
多人协作项目里，
和
不一致是最隐蔽的坑——哪怕 JSON 合法，lock 里存着已删除包的元数据，也会触发解析异常。
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"require": { "foo/bar": "^1.0", }'name': "my/app""name": "my/app"name: "my/app"// 注释/* ... */JSONPlain TextJSON with Commentspython3 -m json.tool composer.jsonExpecting property name enclosed in double quotesphp -l composer.jsoncomposer validateinstallcomposer validatenamevendor/name"version": "dev-main"Invalid version string"repositories": [{ "type": "gitlab", "url": "..." }]type"vcs""autoload": { "psr-4": { "App\": "src//" } }dump-autoload"config": { "allow-plugins": { ... } }composer validatecomposer install --dry-runcomposer installvendor/composer.lockcomposer clear-cache~/.composer/cache--no-cachecomposer install --no-cacheautoloadcomposer dump-autoload -ocomposer.lockcomposer.json