composer validate 默认不显示具体错误行号，因依赖JSON Schema校验而非语法解析；可用--verbose查看堆栈、VS Code JSON插件实时标错；require包名须小写且仅含字母数字和短横线，版本号需合规，autoload键值结构须严格匹配schema。
composer validate 报错但没说清哪行错了
默认 composer validate 只提示“Invalid”或“does not match the expected JSON schema”，不指明具体字段或行号。这是因为 Composer 用的是 JSON Schema 验证，错误信息来自底层库，不是语法解析器。
- 加
--no-check-all参数跳过部分校验（比如跳过require包名格式检查），快速定位是否是 schema 结构问题 - 用
composer validate --verbose看完整报错堆栈，有时会暴露真实校验路径（比如卡在autoload.psr-4的值类型上） - 最稳的办法：把
composer.json拷进 VS Code，装好JSON插件，它会实时标红语法/结构错误——比命令行快得多
require 里写错包名或版本号导致 validate 失败
常见现象是 composer validate 不报错，但后续 composer install 报 Could not find package xxx；而有些严格模式下（如启用了 config.allow-plugins 或某些 CI 配置），validate 也会提前拦截。
-
require中的包名必须全小写、只含字母数字和短横线（vendor/name），myVendor/MyPackage会过不了 schema - 版本号不能写
^1.0.0-beta这种带字母的预发布版，除非显式加上minimum-stability和prefer-stable配置 - 别手误把
"php": ">=8.1"写成"php": ">= 8.1"—— 多个空格会导致 JSON 值类型变成字符串而非对象，schema 校验直接失败
autoload 配置写错引发 validate 异常
autoload 是 composer.json 里最容易写挂的部分，尤其 psr-4 和 classmap 混用时。Validate 不会检查路径是否存在，但会严查键值结构是否符合 schema。
-
psr-4的 key 必须以结尾（如"App\": "src/"），漏掉反斜杠会触发Additional properties not allowed -
classmap的值必须是数组（哪怕只有一个路径），写成"classmap": "src/Utils"（字符串）会直接被 schema 拒绝 - 如果用了
exclude-from-classmap，它的值也必须是数组，空数组[]合法，null或省略都不行
PHP 版本或扩展依赖写在 config 里反而让 validate 失效
有人想用 config.platform.php 锁定 PHP 版本供 CI 使用，结果 validate 报错说 platform 不在允许字段列表里——这是因为 platform 属于 config 子项，而旧版 Composer（
- 运行
composer --version确认当前版本；platform支持从 Composer 2.0.9+ 才稳定 - 若必须兼容老环境，改用
config.platform的替代写法：config.platform.php换成require.php（虽然语义不同，但能绕过 schema 校验） -
config.sort-packages、config.autoload-dev这类较新的配置项，同样存在版本兼容问题，validate 前先查对应 Composer 版本的 schema 文档
真正麻烦的不是报错本身，而是验证通过后，composer install 还是失败——因为 validate 只管 JSON 结构和基础字段，不管包名是否存在、路径是否可读、PHP 扩展是否启用。校验只是第一道筛子，别把它当万能钥匙。
