composer.json“无效”本质是json解析失败，需用php -r定位错误偏移，检查bom、中文符号、控制符等；validate默认不校验语义，加--strict才启用完整schema校验。
composer.json 报“无效”基本就是 JSON 解析失败，不是网络、缓存或权限问题——它根本没走到下载那步，卡在第一行读取上。必须当场修文件，重装、换镜像、composer clear-cache 全无效。
用 php -r 定位错误行和具体字符
Composer 自身报错不带精确行列号，但 PHP 原生 json_decode() 可以。直接运行：
php -r "$j = file_get_contents('composer.json'); $d = json_decode($j); if (!$d) { echo 'Error: ' . json_last_error_msg() . ' at offset ' . json_last_error_offset() . "\n"; }"
输出类似 Error: Syntax error at offset 247，再用编辑器跳转到该偏移位置（VS Code 可按 Ctrl+G 输入 `:247` 查近似行）。常见结果：
- offset 附近出现
Unexpected token }→ 多了一个}或少了一个{ -
Unexpected character→ 混入了中文引号、全角逗号、零宽空格或 Word 复制来的换行符 -
Control character error→ 粘贴时带入了u2028或uFEFF这类不可见控制符
检查 BOM 和编码问题（Windows 用户必看）
Windows 记事本默认保存为 UTF-8 with BOM，PHP 解析时会把 BOM 当作非法开头字符，直接报 Syntax error。验证方法：
head -c 3 composer.json | xxd
若输出含 ef bb bf，就是 BOM。修复方式：
- VS Code 打开文件，右下角点击编码（如显示
UTF-8 with BOM），点击切换为UTF-8并保存 - Linux/macOS 终端执行：
sed -i '1s/^//' composer.json（GNU sed） - macOS（Homebrew）：
gsed -i '1s/^//' composer.json
composer validate 为什么没报错，install 却崩了？
composer validate 默认只校验基础 JSON 语法 + 必填字段存在性，不查语义合法性。以下写法都能过 validate，但 install 一定失败：
-
"type": "lib"→ 正确值只能是"library"、"project"等预定义枚举 -
"autoload": {"psr-4": {"App": "src"}}→ 路径末尾缺/，且键名漏了双引号 -
"require": {"php": "^8.1"}→ 当前 PHP 版本是 8.0，validate不校验环境兼容性
加 --strict 才启用完整 schema 校验：composer validate --strict。它会报出字段值非法、弃用键名（如 archive）、未知顶级键等细节。
别信编辑器高亮，用 JSON Schema 实时拦错
很多编辑器对 composer.json 的特有字段（如 allow-plugins、config/platform）不校验，仅检查括号配对。真正有效的预防方式是绑定官方 Schema：
- VS Code 设置中添加：
"json.schemas"关联到 https://www.php.cn/link/16543006525cbf0f74654bced183cffe - 确保文件右下角显示
JSON with Schema，而非Plain Text或仅JSON - 输入
autoloader会立刻标红提示应为autoload；输错"type": "lib"也会提示枚举值不符
最麻烦的不是语法错本身，而是错误信息不指明位置，加上编辑器自动补全、复制粘贴时混入的不可见字符，往往要花十分钟才能定位一个逗号。每次手动改 composer.json 都该先跑一遍 php -r 验证，而不是等 install 失败再回头找。
