composer validate 仅校验 composer.json 的 JSON 语法及 Composer 官方 schema 规则，包括字段类型、必填项（如 name）、依赖格式、版本约束合法性等，不执行下载安装，也不检查 PHP 代码或 composer.lock。
composer validate 会检查哪些问题
它只校验 composer.json 的 JSON 语法和 Composer 自身的 schema 规则，比如字段类型、必填项、依赖包名格式、版本约束写法是否合法。不会执行任何下载或安装动作，也不检查 PHP 代码本身。
常见错误现象包括：JSON parse error: syntax error（少逗号、多逗号、单引号）、name is required（缺 name 字段）、version constraint is invalid（比如写成 "^8.0.0" 却漏了双引号，或用了不支持的运算符如 !=）。
- 必须在项目根目录下运行，否则报
No composer.json found - 如果项目有
composer.lock，validate不校验它；要用composer install --dry-run或composer update --dry-run间接验证锁文件一致性 - 默认只检查当前目录的
composer.json；想校验子目录中的配置，得加路径参数：composer validate path/to/composer.json
composer.json 中容易被忽略的语法坑
不是所有合法 JSON 都是合法的 composer.json。Composer 对字段有强 schema 约束，尤其在 require、autoload 和 scripts 这几块。
典型翻车点："autoload": {"psr-4": {"App\": "app/"}} 少了末尾斜杠会报 Invalid PSR-4 mapping；"require": {"php": ">=8.1"} 写成 "php": ">= 8.1"（带空格）就触发 Invalid version constraint。
-
version字段不是必须的，但发布到 Packagist 时必须有且格式要匹配 semver（如"1.2.3"），不能写"dev-main"或"latest" -
repositories数组里每个对象必须含type和url，漏掉任意一个就直接失败 - 注释（
//或/* */）在 JSON 中非法，哪怕只是临时加一行说明也会导致validate报错
用 json_decode() 手动校验更早发现问题
如果你在 CI/CD 流程里需要快速甩开 Composer 依赖做前置检查，或者想在编辑器里实时反馈，直接调 PHP 的 json_decode() 更轻量、更快。
示例脚本片段：
$json = file_get_contents('composer.json');
$data = json_decode($json, true);
if (json_last_error() !== JSON_ERROR_NONE) {
echo 'JSON error: ' . json_last_error_msg();
exit(1);
}注意：这只能捕获语法错误，无法替代 composer validate 的语义校验（比如字段是否存在、值是否符合 Composer 规范）。两者互补，不互斥。
- Windows 下注意换行符可能导致
json_decode()返回null，建议先用trim() -
composer validate --no-check-all可跳过某些耗时校验（如远程包存在性），适合本地快速过一遍 - VS Code 用户可装插件
Composer JSON Schema，自动按官方 schema 提供补全和标红提示
CI 环境中 validate 失败但本地正常？查这三处
常见于 Git 换行符处理、PHP 版本差异、或 Composer 版本太老。特别是 composer.json 里用了新语法（如 ^2.5 表示最低兼容 Composer 2.5+），旧版 CLI 会静默忽略或报奇怪错误。
- CI 脚本里显式指定 Composer 版本：
composer self-update 2.5.8，再跑composer validate - 检查 Git 的
core.autocrlf设置，避免 Windows 提交的文件在 Linux CI 上因 CRLF 导致 JSON 解析失败 - 确认 CI 使用的 PHP 版本不低于
composer.json中config.platform.php声明的版本，否则validate可能跳过部分检查
schema 校验逻辑藏在 Composer 源码的 src/Composer/Json/JsonValidator.php 里，但真出问题时，盯住错误信息里的具体字段和提示词比翻源码更省时间。
