必须安装redhat.vscode-yaml插件，否则Shift+Alt+F对YAML无效；需手动切语言模式为YAML、禁用Prettier的YAML支持、配置默认格式化器、设tabSize为2、绑定JSON Schema并重载窗口。
Ctrl + Shift + L：多行加注释不是“块注释”，而是逐行加 #
YAML 本身没有块注释语法，Ctrl + Shift + L 的作用是“为选中每一行开头插入光标”，再配合手动输入 # 实现批量注释。它不是像 C/JS 那样用 /* */ 包裹——那在 YAML 里会直接报错。
常见误操作是：选中 5 行后按 Ctrl + Shift + L，然后敲一个 #，结果只在第一行生效（因为光标只在第一行）。正确做法是：
- 选中多行 → 按
Ctrl + Shift + L（每行开头出现独立光标）→ 再按#（所有光标同步输入） - 若已输错，按
Esc退出多光标模式，否则后续输入会重复出现在所有光标位置 - 取消注释同理：选中带
#的多行 →Ctrl + Shift + L→Home→Delete（删掉每行开头的#和空格）
Shift + Alt + F：格式化依赖 redhat.vscode-yaml，否则静默失败
没装 redhat.vscode-yaml 插件时，Shift + Alt + F 对 YAML 文件基本无效——VS Code 默认不绑定任何 YAML 格式化器，它要么跳过，要么 fallback 到 esbenp.prettier-vscode（而 Prettier 默认不处理 YAML 语义）。
确认是否生效的最快方式：
- 右下角语言模式必须显示
YAML（不是Plain Text或JSON） - 按
Ctrl + Shift + P→ 输入Format Document With...→ 看列表里是否有YAML Language Server - 若没有，检查是否被 Prettier 抢占：在
settings.json中加"prettier.disableLanguages": ["yaml"]
Ctrl + Shift + O：快速定位资源结构，比肉眼扫 spec metadata 快 10 倍
Ctrl + Shift + O（大纲视图）能解析当前 YAML 的层级结构，直接列出所有顶级键（如 apiVersion、kind、metadata、spec），点击即可跳转。对 Kubernetes 清单尤其有用——比如你想改 containers 下的 env，不用展开 4 层缩进，直接在大纲里点开 spec → template → spec → containers 即可。
注意点：
- 大纲内容依赖
redhat.vscode-yaml的 Schema 解析能力，没配yaml.schemas时只显示基础键名，不展开 Kubernetes 特定字段（如replicas、selector） - 如果大纲为空或只显示 “No symbols found”，说明插件未识别为有效 YAML（检查是否有非法字符、缩进混乱，或文件编码不是 UTF-8）
Ctrl + Space：触发 Kubernetes 字段补全，但得先让插件“认出这是 K8s 文件”
Ctrl + Space 在 YAML 文件里能唤出补全建议，但只有当 redhat.vscode-yaml 判定这是 Kubernetes 配置时，才会给出 Deployment、Service 等资源类型和对应字段。判定逻辑优先级是：
- 文件路径匹配
yaml.schemas中的"kubernetes"规则（如"**/*.yaml"） - 内容含
apiVersion:且值匹配 Kubernetes API（如apps/v1） - 两者都不满足时，补全退化为通用 YAML 键名（毫无意义）
最容易被忽略的是路径配置写错：必须用相对工作区根目录的 glob 模式，"kubernetes": "./manifests/*.yml" ✅，"kubernetes": "C:/project/manifests/*.yaml" ❌。
