在 VSCode 中校验和格式化 YAML 文件，应组合使用 Red Hat YAML 扩展（支持语法校验、Schema 关联）、Prettier（配置 .prettierrc 并启用保存自动格式化）及本地 yamllint（项目级规则校验），同时注意缩进、冒号后空格、引号和布尔值规范。

在 VSCode 中校验和格式化 YAML 文件，关键在于组合使用可靠的扩展、合理配置、配合基础语法意识——不依赖单一工具，而是建立一套轻量但有效的检查闭环。

装对扩展：Red Hat YAML 是核心

Red Hat 官方维护的 YAML 扩展（ID：redhat.vscode-yaml）是目前最成熟的选择。它基于 yamllint 和 yaml-language-server，支持语法高亮、实时校验、自动补全（如 Kubernetes 或 Ansible schema）、悬停提示和错误定位。

• 安装后默认启用基础校验；如需更严格规则，可配合项目级 .yamllint 配置文件
• 支持通过 yaml.schemas 关联 JSON Schema，实现字段级验证（例如对接 OpenAPI 或自定义结构）
• 禁用其他功能重叠的 YAML 插件（如 older “YAML Support”），避免冲突

统一格式化：Prettier + YAML 插件协同

VSCode 自带的格式化器对 YAML 支持有限，推荐用 Prettier（配合 esbenp.prettier-vscode）并启用 YAML 支持：

• 确保 Prettier 扩展已安装，并在设置中开启 "prettier.enable": true
• 在工作区或用户设置中添加："files.associations": {"*.yml": "yaml", "*.yaml": "yaml"}
• 推荐配置 .prettierrc（项目根目录）：

  { "tabWidth": 2, "useTabs": false, "singleQuote": false, "bracketSpacing": true }

保存时自动格式化（"editor.formatOnSave": true）即可生效，无需额外命令。

校验进阶：用 yamllint 做 CI/CD 前守门员

VSCode 的实时校验不能替代静态检查。在团队协作或交付前，建议本地运行 yamllint：

• 全局安装：pip install yamllint（或用 pipx 隔离）
• 添加项目级 .yamllint（示例）：

  rules:
    braces: {max-spaces-inside: 1}
    brackets: {max-spaces-inside: 1}
    colons: {max-spaces-before: 0, max-spaces-after: 1}
    indentation: {spaces: 2, indent-sequences: true}
    line-length: {max: 120}

• VSCode 可通过 shellcheck 类方式集成（用 Tasks 或终端快捷键），但日常开发中手动运行 yamllint . --config-file=.yamllint 足够清晰

避坑提醒：常见 YAML 陷阱与 VSCode 应对

很多“报错”其实源于 YAML 本身特性，不是工具问题：

• 缩进敏感：VSCode 的缩进指示线（ruler）要打开（"editor.rulers": [2, 4, 80]），用空格而非 Tab
• 冒号后必须空格：写成 key:value 会解析失败；Red Hat 扩展会标红提示
• 字符串含特殊字符要引号：如 url: https://example.com/path?x=1&y=2 → 必须加双引号
• 布尔值大小写敏感：只认 true/false，True 或 YES 属于非标准写法，yamllint 默认报错

基本上就这些。不需要复杂配置，选好 Red Hat YAML + Prettier，配个轻量 yamllint 规则，再留意几个语法细节，YAML 在 VSCode 里就能既安全又顺手。