怎么用VSCode编写YAML配置_VSCode YAML语法检查与自动补全插件-VSCode-PHP中文网

red hat yaml插件不可替代，因其是唯一持续维护、支持yaml-language-server与多schema动态绑定的实现，能精准解析kubernetes/ci/cd等json schema并映射到具体文件路径，而vscode内置支持仅限基础语法，其他插件或过时或冲突。

怎么用vscode编写yaml配置_vscode yaml语法检查与自动补全插件

装 Red Hat YAML 插件 + 正确配 yaml.schemas，是唯一能稳定启用 Kubernetes/CI/CD 字段级补全和校验的组合。其他插件或默认设置基本只能做缩进高亮，连 kind: 后该填 Deployment 还是 Service 都不提示。

VSCode 自带的 YAML 支持（1.86+）只处理基础语法，不带任何语义；Kubernetes 官方插件已多年未更新，不兼容 v1.28+ 的 API 字段；GitHub Actions 扩展会主动禁用其他 YAML 语言服务——三者同时启用必冲突。

Red Hat 插件（redhat.vscode-yaml）是目前唯一持续维护、支持 yaml-language-server + 多 Schema 动态绑定的实现
它能解析远程 JSON Schema 并映射到具体文件路径，比如 docker-compose.yml 和 .github/workflows/ci.yml 可共存且互不干扰
若你看到 spec.template.spec.containers[0]. 后没弹出 image、ports 等字段，90% 是插件没装，或装了但被 Auto Close Tag、Prettier 的 YAML 模式覆盖了

yaml.schemas 不支持正则，也不认 **/k8s/*.yaml 这种 glob；它只匹配文件系统中「实际路径」相对于工作区根目录的字面量或简单通配符（* 和 ** 仅在部分版本有效，推荐用确定路径）。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

推荐写法："https://raw.githubusercontent.com/instrumenta/kubernetes-json-schema/master/master-standalone/all.json": ["*.k8s.yaml", "k8s/*.yml"]
不要写 "**/deploy/*.yaml" —— VSCode 会静默忽略
如果文件名是 deployment.template.yaml，需先加后缀关联："files.associations": {"*.template.yaml": "yaml"}，再在 yaml.schemas 中配 "*.template.yaml"
Schema URL 必须返回 HTTP 200；https://json.schemastore.org/github-workflow.json 稳定，但 kubernetes-json-schema 的 raw URL 偶尔因 GitHub 限流超时，可缓存本地（UTF-8 无 BOM）

VSCode 对 YAML 极其敏感：语言模式错、缩进混用、注释位置不对，都会让整个语言服务降级为纯文本处理。

右下角必须显示 YAML（不是 Plain Text 或 GitHub Actions）；若显示后者，按 Ctrl+Shift+P → Change Language Mode → 选 YAML
缩进必须统一为「2 个空格」；Tab 和空格混用会导致 yaml-language-server 直接跳过该行校验
注释不能紧跟字段后换行：port: 80 # comment\nenv: 这种写法会让 env 被忽略，建议换行后空一行再写新字段
手动触发补全：Ctrl+Space；如果仍无反应，在 Developer: Toggle Developer Tools 的 Console 里搜 connection refused 或 schema not found

同一个 YAML 插件可以支持多种格式，但必须显式告诉它「哪个文件对应哪个 Schema」；Kubernetes 的 Schema 对 docker-compose.yml 完全无效，反之亦然。

Docker Compose："https://raw.githubusercontent.com/compose-spec/compose-spec/master/schema.json": ["docker-compose.yml", "compose.yaml"]
GitHub Actions："https://json.schemastore.org/github-workflow.json": [".github/workflows/*.yml"]
Ansible Playbook："https://json.schemastore.org/ansible-stable-2.9.json": ["*.playbook.yml"]（注意版本号需匹配你用的 Ansible）
切勿把多个 Schema 绑定到同一组路径，例如 "*.yml": [k8s_url, gh_url] —— 服务器只会加载第一个

最常被忽略的是：Schema 绑定后，必须关闭再重新打开文件，或执行 Developer: Reload Window，否则旧缓存不会刷新。另外，yaml-language-server 启动有延迟，刚打开大文件时补全可能卡 1–2 秒，别急着关插件。