Composer提示composer.json语法错_使用validate命令校验【纠错手册】-composer-PHP中文网

composer validate报错90%是composer.json硬伤，应先用php -r调json_decode定位纯语法错误（如第12行第5列非法字符），再查末尾逗号、单引号、中文标点、bom头；validate通过不代表install成功，需加--strict校验语义、清缓存、检查lock文件一致性。

composer提示composer.json语法错_使用validate命令校验【纠错手册】

composer validate 报错，90% 是 composer.json 本身有硬伤，不是 Composer 坏了，也不用重装。 它报的错往往直指行号和列号，但编辑器显示、换行符、BOM、引号类型这些干扰项会让定位变慢。关键不是“怎么让它不报错”，而是“怎么快速确认错在哪、为什么错、改完还缺哪步”。

用 `php -r` 直接调 `json_decode()` 定位语法硬伤

这是最干净、绕过所有 Composer 层级的验证方式，只测纯 JSON 是否可解析。

php -r "json_decode(file_get_contents('composer.json')) || die('JSON error: ' . json_last_error_msg());" —— 输出带具体错误信息，比如 Syntax error on line 12 at column 5，说明第 12 行第 5 列附近有非法字符
常见硬伤：末尾多逗号（"foo": "bar", 在对象最后一项）、单引号代替双引号（'name': 'test'）、中文标点（“”、，、：）、BOM 头（Windows 记事本保存后常见）
别信编辑器“格式化”按钮——它可能把 "psr-4": { "App\": "src/" } 这种路径错误自动补成看似整齐但依然非法的结构

为什么 `composer validate` 有时沉默，`install` 却崩了

composer validate 默认只做两件事：基础 JSON 解析 + 检查必需字段（如 name、require）是否存在。它不管值合不合法。

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

"version": "dev-main" —— JSON 合法，validate 通过，但 Packagist 上没这个版本，install 直接报 Could not find package
"repositories": [{ "type": "gitlab", "url": "..." }] —— type 拼错（正确是 vcs），validate 不拦，install 卡在 fetch 阶段
"autoload": { "psr-4": { "App\": "src//" } } —— 路径末尾双斜杠，JSON 合法，validate 不报，但 dump-autoload 会警告目录不存在
想提前暴露这类问题，加 --strict：composer validate --strict --no-check-publish

编辑器和编码陷阱比语法更难排查

VS Code 或 PHPStorm 显示“无错误”，不代表文件真没问题。很多问题藏在元数据里。

右下角必须显示 JSON（不是 Plain Text 或 JSON with Comments），否则不触发语法高亮和校验
编码必须是 UTF-8 without BOM：Windows 记事本默认带 BOM，file -i composer.json（Linux/macOS）或 Notepad++ 的“编码”菜单可确认；VS Code 右下角点编码名 → “Save with Encoding” → 选 UTF-8
从网页复制配置？先粘到记事本再中转一次，过滤隐藏控制字符（比如零宽空格）
私有仓库 URL 里含 & 或空格？必须 URL 编码，否则解析时被截断，报错位置会偏移