vscode kubernetes插件仅连接操作已有集群，95%功能失效源于kubectl或kubeconfig未正确配置；需验证kubectl版本≥1.18、kubeconfig路径权限合法、语言模式设为kubernetes、显式执行connect to cluster命令，并确保kubectl能正常访问集群。
VSCode 的 Kubernetes 插件不部署集群，只连接、查看和操作已有集群；所有功能失效的根源，95% 是 kubectl 或 kubeconfig 没对上，不是插件坏了，也不是你配错了“高级选项”。
确认 kubectl 和 kubeconfig 能通，再动 VSCode
插件启动时硬检查两件事：PATH 里有没有可执行的 kubectl（≥1.18），以及能否读到格式合法、权限正确的 kubeconfig。它不认 KUBECONFIG 环境变量拼接，也不 fallback 到其他路径。
- 终端运行
kubectl version --client，必须返回版本号；否则插件直接报错退出 - 运行
kubectl config current-context，输出必须是你想连的目标上下文名（如minikube或aws-eks-prod） - 运行
kubectl get nodes -A，必须成功返回节点列表；若报Unable to connect to the server，插件必然连不上 -
kubeconfig文件权限要对：macOS/Linux 上运行ls -l ~/.kube/config，确保当前用户有读权限；Windows 上注意文件是否被系统标记为“来自互联网”而被拦截
语言模式必须是 Kubernetes，否则补全、校验、部署按钮全失效
打开一个 deployment.yaml，右下角显示的是 YAML 或 YAML (Kubernetes)？那就还没到位。只有纯 Kubernetes 模式才触发插件绑定的 schema 校验和资源树联动。
- 点击右下角语言模式标签 → 选择
Change Language Mode→ 输入kubernetes并回车 - 如果列表里没有
Kubernetes，说明redhat.vscode-yaml插件没装或没生效 - 输入
apiVersion:后应立刻弹出apps/v1、batch/v1等建议；没反应 = 语言服务器没加载成功 - 别依赖自动检测——VSCode 不会根据文件内容猜语言模式，必须手动切
连接集群不是“选个上下文”，而是显式触发一次 Connect to Cluster
命令面板里运行 Kubernetes: Select Context 只改本地记忆，不发请求；资源树为空、右键菜单不出现、小火箭按钮灰色，大概率卡在这一步。
- 点击左侧 Kubernetes 图标 → 顶部资源树右上角点
Connect to Cluster→ 选目标 context - 连接成功后，右下角状态栏必须显示类似
k8s-context: eks-prod；鼠标悬停能看到 server 地址 - 此时展开资源树，应看到命名空间列表；若仍为空，检查
kubectl auth can-i list pods -A是否返回yes - 插件不缓存，每次展开都发新请求；网络慢或权限不足就会“一直转圈”，这不是 bug
kubectl apply 按钮灰色？两个条件缺一不可
小火箭图标（Deploy）依赖两个独立状态：一是插件已加载有效 kubeconfig 路径，二是插件已显式连接到某个上下文。只配路径不连接，按钮永远灰色。
- 先确认
kubectl在终端能跑通；再确认插件已通过Connect to Cluster成功连接 - 右键 YAML 文件 → 若出现
Deploy Kubernetes Resource菜单项，说明路径和连接都 OK - 若点击后报错
command 'kubectl.apply' not found，常见于 VSCode 运行在 Windows 主系统但kubectl只装在 WSL 里——得用Remote-WSL扩展，或把 WSL 的kubectl软链进 Windows PATH - 部署失败时，看 VSCode 的 OUTPUT 面板 → 选
Kubernetes，里面会打印真实kubectl apply命令和 stderr 输出
最常被忽略的点：插件从不自动拉取你集群实际启用的 CRD（比如 VirtualService、IngressRoute），所以字段补全和校验永远只覆盖标准 API；要用扩展资源，得手动配置 yaml.schemas 指向对应 CRD 的 OpenAPI spec，且这个 spec 必须是你集群真实启用的版本。
