运行 composer validate 可检查 composer.json 的 JSON 合法性及 Composer 字段规范，无输出即通过；支持 --strict、--no-check-lock 等选项增强校验，适用于 CI/CD 门禁，常见错误包括 name 格式不符、误设 version 等。
直接运行 composer validate 即可检查 composer.json 文件的语法和结构是否符合规范。
基础验证：检测 JSON 格式与 Composer 规范
该命令会做两件事：先解析 JSON 是否合法，再校验字段是否符合 Composer 的 schema（比如 name 格式、version 是否多余、依赖包名是否合法等）。
- 在项目根目录下执行：
composer validate - 若无输出，说明通过；若有错误，会明确指出哪一行、哪个字段有问题
- 默认只检查当前目录下的
composer.json，不递归子目录
常用选项增强检查效果
可以根据需要添加参数，让验证更严格或更灵活：
-
--no-check-all：跳过对所有已安装包的composer.json验证（默认只验当前项目） -
--strict：启用严格模式，把警告（如缺少description或license）也当作错误处理 -
--no-check-lock：不校验composer.lock是否与composer.json同步（避免锁文件过期干扰验证）
配合 CI/CD 或脚本自动检查
在自动化流程中，建议加上 --strict 确保元数据完整：
- 例如 GitHub Actions 中可写：
run: composer validate --strict - 返回值为 0 表示成功，非 0 表示失败，适合用作门禁条件
- 如果项目使用了自定义平台仓库或私有包，只要
composer.json本身格式和字段合规，不影响 validate 通过
常见报错及快速修复
遇到典型提示时，可按以下方式定位：
-
[Composer\Json\JsonValidationException] ... does not match the regex pattern：通常是name字段含非法字符（如大写字母、空格），应为vendor/package-name小写格式 -
Warning: The version field is present...：发布包时不应手动写version，由 VCS 标签决定，删掉该行即可 -
Invalid argument supplied for foreach()：一般是某个数组字段（如require）被误写成字符串或 null，需检查缩进和逗号
