Kubernetes Templates插件仅生成必填字段的最简YAML骨架，非必填字段如resources、livenessProbe需手动补充；默认不包含自定义API版本模板，需手动添加；依赖Red Hat YAML插件提供补全与校验，且须正确配置语言模式、Schema绑定及缩进设置。
为什么 Kubernetes Templates 插件生成的 YAML 字段不全
它只生成最简骨架，不带 resources、livenessProbe、namespace 这类非必填字段——这是设计使然，不是 bug。Kubernetes API 规范里只有 apiVersion、kind、metadata.name 和核心 spec 结构是强制字段，其余都靠你手动补全。
常见错误现象：生成完 Deployment 后直接 apply，Pod 一直 Pending，查日志发现没设 resources.requests，集群调度器拒绝分配。
- 用插件生成后，立刻按
Ctrl+Space触发 Red Hat YAML 插件的补全，在spec.template.spec.containers[0].后输入res，会提示resources - 想默认包含常用字段？在插件设置里搜
kubernetes-templates.defaultFields，手动加进["resources", "livenessProbe", "readinessProbe"]（需插件 v0.5.0+） - 别依赖模板覆盖全部场景；它本质是“起点”，不是“终稿”
如何让 Kubernetes Templates 插件识别自定义 API 版本
插件内置模板只覆盖主流版本（如 apps/v1、batch/v1），遇到 helm.sh/v2 或内部 CRD（比如 argoproj.io/v1alpha1），默认不出现。
使用场景：你在写 Argo Workflows 或 Helm Chart 的 values.yaml，但右键菜单里没有对应模板选项。
- 打开命令面板（
Ctrl+Shift+P），运行Kubernetes: Add Custom Template - 填入名称（如
Argo Workflow）、API 组（argoproj.io）、版本（v1alpha1）、资源类型（Workflow） - 保存后，右键 →
Insert Kubernetes Template就会出现新条目 - 注意：该模板只是结构占位，字段校验仍依赖 Red Hat YAML 插件 + 对应 Schema 绑定
生成的 YAML 无法触发 Red Hat YAML 的字段补全
根本原因：Kubernetes Templates 插件只负责写内容，不切换语言模式、不绑定 Schema。如果文件仍是通用 YAML 模式，apiVersion: apps/v1 后敲 kind: 不会弹出 Deployment 建议。
容易踩的坑：以为装了两个插件就自动联动，结果补全和校验全失效。
- 生成模板后，务必点击右下角语言模式（显示
YAML），选Change Language Mode→ 输入kubernetes回车 - 确认
settings.json中"yaml.schemas"已正确映射到 instrumenta 的 Schema URL，路径通配符用"**/*.yaml"，不是"*.yaml" - 改完配置必须关闭再重开文件，缓存不刷新，补全不会生效
- 检查 Red Hat YAML 插件是否启用：扩展列表里找
redhat.vscode-yaml，状态得是“已启用”
模板插入位置错乱或缩进崩坏
VSCode 默认缩进设置（如 “Detect Indentation” 开启）会干扰模板的 2 空格对齐，尤其粘贴进已有文件时，可能整个 spec 块向右偏移 4 格甚至更多。
性能影响：缩进错位本身不报错，但会导致 kubectl apply 解析失败，错误信息是 error converting YAML to JSON，定位困难。
- 关掉 VSCode 的自动检测：设置里搜
editor.detectIndentation，设为false - 统一设为 2 空格缩进：
"editor.insertSpaces": true和"editor.tabSize": 2 - 生成模板前，把光标放在空行或正确层级（比如想插在
spec:下，就停在该行末尾再触发命令） - 生成后立刻按
Shift+Alt+F（Windows/Linux）或Shift+Option+F（macOS）格式化，依赖的是 Red Hat YAML 插件内置格式器
