Ctrl+Shift+O可一键展开YAML文件完整节点树，展示apiVersion、kind等顶层字段及嵌套层级，不依赖Schema绑定，但大纲为空说明存在缩进错误或缺少---分隔符。
Ctrl+Shift+O：快速查看YAML文件结构大纲
这个快捷键能一键展开当前 YAML 文件的完整节点树，特别适合处理几十行以上的 Kubernetes Deployment 或 StatefulSet。它不依赖插件是否启用 Schema，只要语法合法就能解析出 apiVersion、kind、metadata、spec 等顶层字段及其嵌套层级。
常见误用是把它当成“跳转到定义”，但它实际只做结构展示；想跳转字段定义得靠悬停或 Ctrl+Click（需插件支持 Schema）。如果大纲为空或只显示根节点，说明文件存在严重缩进错误或缺少 --- 分隔符（多文档时）。
- 按完后光标仍在原位，不影响编辑流
- 对含
include或锚点（&anchor）的文件不解析引用关系，仅展示字面结构 - 在
values.yaml（Helm）中同样有效，但不会关联templates/下的实际模板
Ctrl+Space：触发 Kubernetes 字段级自动补全
必须满足两个前提：已安装 redhat.vscode-yaml 插件，且 yaml.schemas 正确绑定了 kubernetes 模式。否则只会补全基础 YAML 关键字（如 true、null），而不会出现 livenessProbe、tolerations 这类 Kubernetes 特有字段。
补全内容取决于你当前光标位置的上下文。例如在 spec: 下按 Ctrl+Space，会列出 containers、volumes、initContainers；而在 containers: 下，则优先推荐 name、image、ports 等必填字段。
- 补全项右侧带 ? 图标的，表示该字段有官方文档链接，悬停可查看说明
- 输入
env:后按Ctrl+Space，会直接建议- name:和valueFrom:，而非让你手动敲破折号 - 若补全列表为空，检查右下角语言模式是否为
YAML（不是Plain Text），并确认settings.json中"kubernetes": "**/*.yaml"已生效
Ctrl+Shift+L：块注释 YAML 行（非标准，但实用）
VS Code 原生不支持 YAML 块注释（YAML 本身也不定义块注释语法），Ctrl+Shift+L 实际执行的是“行注释”：在选中行首插入 #。它不是真正意义上的块注释，但对临时禁用某段配置（比如整个 ingress 块）足够高效。
注意：YAML 不允许在 key: value 行中间加 # 来注释值（如 replicas: 3 # old value 是合法的），但用 Ctrl+Shift+L 注释整行时，会把 # 插入到行首，可能破坏缩进层级——比如注释掉一个 ports: 下的条目，结果变成顶格的 # - containerPort: 8080，导致后续字段解析失败。
- 安全做法：先选中要注释的行，确保它们缩进一致，再按
Ctrl+Shift+L - 避免对空行或只有缩进的行使用，容易引入不可见的空白字符问题
- 想恢复时，
Ctrl+Shift+L同样适用，但需手动清理多余空格（插件不会自动修复）
Shift+Alt+F：格式化前必须确认绑定的是 YAML Language Server
这个快捷键调用的是当前语言模式绑定的格式化器。没装 redhat.vscode-yaml 时，VS Code 默认无 YAML 格式化能力，Shift+Alt+F 可能静默失败，或意外调用 esbenp.prettier-vscode（如果已安装），而 Prettier 对 Kubernetes YAML 的语义理解有限，常把 env: 和 ports: 格式化成同级，破坏嵌套结构。
验证方法：按 Ctrl+Shift+P → 输入 Format Document With…，列表中应出现 YAML Language Server。如果没有，说明插件未生效或被抢占。
- 解决冲突：在
settings.json中添加"prettier.disableLanguages": ["yaml"] - 格式化后仍报错？打开
renderWhitespace（设为"all"），查看是否有多余空格或 Tab 混用 - 格式化不会修正语义错误（如拼错
imagePullPolicy），只调整缩进和换行
Kubernetes YAML 编写里最隐蔽的问题，往往不是语法错，而是 Schema 绑定路径写成绝对路径（如 ~/schema.json）或通配符没覆盖到实际文件（比如配了 "*<em>/k8s/</em>.yaml" 却把文件放在 manifests/ 目录下）。这些细节不报错，但补全和校验直接失效。
