不能直接用 Docker Compose 验证 Kubernetes YAML 语法，因其语法、对象模型和运行时完全不同；应使用 kubectl --dry-run=client、datree 或 kubeval 等 K8s 原生工具进行语法与策略校验。
不能直接用 Docker Compose 验证 Kubernetes YAML 语法，因为两者语法、对象模型和运行时完全不同。Compose 是为 Docker 容器编排设计的（docker-compose.yml），而 K8s 使用的是原生 API 对象定义（如 Deployment、Service 等），需通过 K8s 工具链校验。
用 kubectl --dry-run=client -o yaml 快速语法检查
这是最轻量、无需集群连接的本地验证方式，仅依赖 kubectl 和已安装的 K8s client 配置（如 ~/.kube/config）：
- 执行
kubectl apply -f your-app.yaml --dry-run=client -o yaml > /dev/null - 若输出空且返回码为 0，说明 YAML 结构合法、字段名拼写正确、嵌套层级合理
- 若报错如
error: unable to recognize "xxx": no matches for kind "Depolyment" in version "apps/v1"，说明资源类型拼错或 API 版本不匹配 - 注意：
--dry-run=client不校验权限、RBAC、镜像是否存在等运行时逻辑，只做客户端 Schema 校验
用 datree 做策略+语法双检
Datree 是专为 K8s YAML 设计的 CLI 工具，能同时检查语法错误、K8s 最佳实践（如是否设置 resource limits）、合规性规则：
Browser Setup (No-Root Linux)
下载
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
- 安装后运行
datree test your-app.yaml - 自动识别常见问题：缺失
spec.selector、matchLabels与template.metadata.labels不一致、使用已弃用 API（如extensions/v1beta1） - 支持自定义规则集，适合团队统一规范
- 纯静态分析，不依赖集群，适合 CI/CD 前置检查
用 kubeval 进行离线 Schema 校验
kubeval 是老牌 YAML Schema 验证工具，支持指定 K8s 版本（如 --kubernetes-version 1.28.0）：
- 运行
kubeval --kubernetes-version 1.27.0 your-app.yaml - 会报告字段缺失（如
spec.template.spec.containers[0].name未设）、类型错误（如把整数写成字符串）、API 版本废弃提示 - 可集成进 Makefile 或 pre-commit hook，例如：
make validate: kubeval --kubernetes-version $(K8S_VERSION) *.yaml
避免误用 Compose 的常见误区
有人尝试用 docker-compose config 解析 K8s YAML，这不可行：
- Compose 解析器不认识
apiVersion、kind、metadata.namespace等字段，会直接报错或静默忽略 - 即使 YAML 格式上“看起来像 YAML”，Compose 也不会触发 K8s 的 OpenAPI Schema 校验逻辑
- 真正需要的是 K8s 原生工具链 —— 不是换工具，而是选对工具
