应安装官方 kubernetes 插件（ms-kubernetes-tools），确保本地 kubectl 可用且 kubeconfig 有效，配置 red hat yaml 插件与正确 schema 链接，并注意命名空间、权限及 crd 显示设置。
怎么装对插件，而不是装一堆名字像的
VSCode 里搜 “kubernetes” 会出来十几个插件，真正能连集群、看资源、编辑 YAML 的只有 Kubernetes 官方插件（作者是 ms-kubernetes-tools）。别选错成 Kubernetes Extension Pack 或 vscode-k8s 这类已弃用/功能残缺的——它们要么不支持新版 kubectl 配置，要么连 ~/.kube/config 都读不全。
安装后必须重启 VSCode，否则状态栏不显示集群信息。插件依赖本地 kubectl，如果命令行运行 kubectl get ns 报错，插件一定连不上。
- 确认
kubectl在系统 PATH 里：which kubectl或where kubectl（Windows） - 检查当前 kubeconfig 是否有效：
kubectl config current-context和kubectl auth can-i list pods - 插件默认只读取
~/.kube/config，不支持KUBECONFIG环境变量多文件拼接（除非你手动在插件设置里填绝对路径）
为什么点开资源列表是空的，或者一直转圈
插件右下角显示了当前 context，但资源树（KUBERNETES 面板）为空，大概率是权限或命名空间范围问题。它默认只拉取 default 命名空间下的资源，且不会自动 fallback 到 all-namespaces。
- 点击状态栏的
default，可切换命名空间；选All namespaces才能看到全部 Pod/Deployment - 如果切换后仍为空，检查当前 context 对应用户的 RBAC 权限：
kubectl get pods -A能跑通，插件才可能拉到数据 - 插件不缓存结果，每次展开节点都发一次
kubectl get请求——网络慢或集群响应卡顿，就会“转圈半天” - 某些 CRD（比如
ingressroute、knative资源）默认不显示，需在插件设置里开启kubernetes.explorer.showCustomResources
编辑 YAML 时自动补全和校验为啥不生效
插件本身不提供 YAML schema 校验，它靠的是 VSCode 底层的 YAML 插件 + Kubernetes 官方 schema 文件。没补全、没报错提示，90% 是这两个没配好。
- 必须单独安装
Red Hat YAML插件（作者redhat.vscode-yaml），否则连缩进、折叠都不正常 - 在 YAML 文件顶部加注释声明 schema：
# yaml-language-server: $schema=https://raw.githubusercontent.com/instrumenta/kubernetes-json-schema/master/v1.28.0-standalone-strict/all.json（版本号按你集群实际改） - 不加这行，或者链接 404，就只有基础语法高亮，没有字段提示、必填项校验、错误定位
- 插件内置的快速插入模板（如 Ctrl+Space 选 Pod）只适用于标准资源，CRD 模板得自己定义或用
kubectl explain手动补
从编辑器直接部署失败，错误信息看不懂
右键 YAML 文件 → Apply to Kubernetes，弹出终端但报错，常见原因不是配置写错，而是上下文或权限链断了。
- 错误含
error: You must be logged in to the server：说明当前 context 指向的集群要求 OIDC 或 token 认证，而本地~/.kube/config里 token 过期或未刷新 - 错误含
Forbidden：插件用的是你当前 shell 的kubectl凭据，但该凭据没被授权操作目标命名空间（比如你在devns 编辑 YAML，却试图 apply 到prod） - 错误含
unable to recognize "": no matches for kind：YAML 里kind拼错了，或用了集群没装的 CRD（比如写了ArgoCD但没装 Argo CD operator） - 插件调用的是
kubectl apply -f /tmp/xxx.yaml，临时文件路径不可见——想复现错误，就复制终端里完整命令，在 shell 里重跑一遍
最常被忽略的一点：插件不会自动 kubectl apply --namespace=xxx，它严格按 YAML 里的 metadata.namespace 字段走。空着这个字段，就默认打到 default，哪怕你当前在别的 namespace 标签页里。
