在 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 里就能既安全又顺手。
