composer validate是唯一校验composer.json语法和结构的官方命令，composer format（2.5.0+）才是安全格式化正解；jq或python工具会删注释、重排字段、污染diff，不应日常使用。
composer validate 是唯一能校验 composer.json 语法和结构的官方命令，而 composer format（2.5.0+）才是安全格式化的正解 —— jq 或 python -m json.tool 会破坏注释、重排字段顺序、污染 diff，不该用于日常维护。
composer validate 怎么用才真有效
它默认只做轻量检查，很多拼写错误、弃用字段、非标准 license 值都会被放过。CI/CD 中必须加 --strict 才算真正校验。
- 基础校验：
composer validate—— 只查 JSON 合法性 + 必要字段是否存在 - 强制拦截低级错误：
composer validate --strict，例如："autoloader"（应为"autoload"）、"type": "libary"（拼错）、"license": "MIT License"（非 SPDX 标准） - 跳过 Packagist 连网检查（CI 必加）：
composer validate --strict --no-check-publish - 验证 lock 文件一致性（有
composer.lock时）：composer validate --lock，防止手动改composer.json后忘了更新 lock
注意：validate 不解析依赖、不检查 PHP 版本兼容性、不验证目录是否存在 —— 它只管“写得对不对”，不管“能不能装”。
composer format 能做什么、不能做什么
composer format 从 Composer 2.5.0 起内置，专为 composer.json 设计：修缩进、空行、引号、末尾逗号，但**不动字段顺序、不删注释、不重排 key**。这是它和通用 JSON 工具的根本区别。
- 确认版本：
composer --version，低于 2.5.0 先composer self-update - 基础使用：
composer format（默认处理当前目录composer.json） - 预览不写入：
composer format --dry-run，返回非 0 表示有格式差异 - 指定路径：
composer format /path/to/composer.json，支持多个路径 - CI 自动校验推荐写法：
composer format --dry-run && echo "✅ OK" || (echo "❌ composer.json needs formatting"; exit 1)
别指望它统一字段顺序（如强制 name→description→require），那是 vaimo/composer-plugin 的 composer normalize 干的事。
为什么 jq 和 python -m json.tool 会搞砸 composer.json
它们把 composer.json 当纯 JSON 处理，但实际它不是：字段顺序影响行为（比如 scripts 执行顺序）、注释虽被忽略但对人有用、某些插件靠原始 key 位置做 hook。
-
jq -S '.' composer.json：按键名强制排序，"name"被推到最前，"autoload"挤到中间，git diff爆炸 -
python -m json.tool：Windows 上默认用系统编码读取，可能乱码；一律删注释；压平多行scripts，可读性归零 - 两者都用双引号重写所有字符串，哪怕你原来写的是
"php": "^8.1"，输出后换行/空格微变，diff里全是噪音
这些工具适合一次性救急，不适合纳入团队工作流 —— 它们解决的是“JSON 是否合法”，不是“composer.json 是否可维护”。
JSON 语法错误怎么快速定位
composer validate 在语法崩了时根本跑不起来，报错就一句 JSON decode error: Syntax error，没行号没列号。这时候得绕过 Composer，直击 JSON 解析层。
- 用 PHP 命令精确定位：
php -r "json_decode(file_get_contents('composer.json')) or die('JSON error: '.json_last_error_msg());"，错误信息带具体位置（如Unexpected control character at line 12, column 5） - 用 jq 快速预检：
jq '.' composer.json，失败时直接标出第几行第几列 - 查隐藏字符：
cat -A composer.json | head -n 15，看有没有^M、M-BM-^或ZWSP（零宽空格 U+200B） - Windows 记事本保存极易带 BOM，务必用 VS Code 或 Vim，并确认右下角显示编码是
UTF-8（不是UTF-8 with BOM）
真正难的从来不是修复那个逗号或引号，而是让所有人默认走同一套工具链 —— composer format 适合日常维护，composer normalize 适合强约束团队；一旦混用，diff 和协作成本就不可逆地上升。
