VSCode 编辑 Kubernetes YAML 文件需配齐三件事：Red Hat YAML 插件提供字段补全与校验、正确绑定 Kubernetes JSON Schema、Kubernetes 插件调用 kubectl 实现资源操作；缺一即退化为普通编辑器。
VSCode 编辑 Kubernetes YAML 文件，核心问题不是“能不能写”，而是“写完有没有校验、补全是否准确、改完能不能立刻验证”——这三件事没配对，就只是个高级文本编辑器。
YAML 文件没补全、没报错提示，90% 是 Red Hat YAML 插件没装或没生效
官方 Kubernetes 插件本身不解析 YAML，它只负责连接集群、展示资源树。真正提供字段提示、必填项标记、缩进折叠、错误定位的，是 Red Hat YAML 插件（作者 redhat.vscode-yaml）。
- 必须单独安装该插件，安装后点击“重新加载窗口”，不能只启用
- 安装完打开一个
deployment.yaml，看右下角语言模式是否显示为YAML (Kubernetes)；如果还是YAML，说明没识别成功 - 手动切换语言模式：
Ctrl+Shift+P→ 输入Change Language Mode→ 选Kubernetes - 若仍不生效，检查
settings.json是否有冲突配置，比如误删了"yaml.schemas"或路径通配符写错
写了 apiVersion 和 kind，但字段不自动补全？schema 绑定没对上
Red Hat YAML 插件靠 JSON Schema 知道 Deployment 有哪些字段、哪些必填、哪些嵌套层级。不绑定 schema，它就只能当普通 YAML 处理。
- 在 YAML 文件顶部加注释声明 schema：
# yaml-language-server: $schema=https://raw.githubusercontent.com/instrumenta/kubernetes-json-schema/master/v1.28.0-standalone-strict/all.json（版本号按你集群实际改，比如v1.27.0） - 或者统一在
settings.json里全局绑定："https://raw.githubusercontent.com/instrumenta/kubernetes-json-schema/master/v1.28.0-standalone-strict/all.json": ["**/*.yaml", "**/*.yml"] - 别用
yannh的旧地址（已归档），instrumenta是当前维护最勤的源 - 网络受限时，可用
kubectl get --raw "/openapi/v2" | jq '.definitions' > kubernetes-schema.json生成本地 schema，再映射到"./kubernetes-schema.json": ["**/*.yaml"]
编辑完保存，点插件里的 “Apply” 按钮没反应？kubectl 没走通
Kubernetes 插件的 Apply、Delete、Port Forward 这些操作，本质是调用本地 kubectl 命令。它不自己实现逻辑，只做封装。
- 先在 VSCode 内置终端里运行
kubectl config current-context和kubectl auth can-i create deployments -n default，确认命令行能通、权限够 - 检查
PATH：VSCode 终端可能没继承系统 PATH，尤其 macOS M1/M2 用户常见；在settings.json中显式加"terminal.integrated.env.osx": {"PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"} - 插件默认只读
~/.kube/config，不认KUBECONFIG环境变量；如需多配置，必须在插件设置里填绝对路径：kubernetes.configPath - 右下角状态栏显示 context 名但资源树为空？先点它切换命名空间，再选
All namespaces；否则默认只拉default下的资源
想秒建 Deployment/Service 模板，别手敲 —— 用 Kubernetes Templates 插件
这个插件不是辅助，是生产力拐点。它把所有官方推荐结构打包成代码片段，敲几个字母就能插入带注释、带占位符、符合当前 API 版本的完整 YAML。
- 搜索安装
Kubernetes Templates（作者ms-kubernetes-tools，注意不是同名其他插件） - 新建空
.yaml文件，在里面输入deploy+Tab，自动展开 Deployment 模板；输svc+Tab出 Service；cm、secret同理 - 模板里所有字段都带
# TODO:注释，比如image: # TODO: specify image，改起来一目了然 - 它不依赖集群连接，离线也能用；但生成的模板版本默认较新，如集群是 v1.25，记得手动把
apiVersion: apps/v1下的字段和 schema 对齐
最容易被忽略的是：schema URL 一旦 404 或版本错配，补全就彻底失效，但 VSCode 不报错，只会静默退化为纯文本编辑——这时候得回头查网络、查链接、查 settings.json 里的路径通配符是否真匹配到了你的文件名。
