vscode kubernetes插件不运行集群，仅通过本地kubectl和kubeconfig连接已有集群；95%问题源于二者未正确配置，需手动触发connect to cluster才能加载资源树并启用部署等功能。
VSCode 本身不运行 Kubernetes 集群，它只连接、操作已有集群；真正能“跑”集群的是本地工具（如 kind、minikube）或云服务（EKS/AKS/GKE），VSCode 通过插件调用你本地的 kubectl 和 kubeconfig 实现集成——95% 的问题不是插件坏了，而是这两样没对上。
确认 kubectl 和 kubeconfig 能通，再谈插件
插件启动时硬检查两件事：PATH 里有没有可执行的 kubectl（≥1.18），以及能否读到有效的 kubeconfig 文件。它不认 KUBECONFIG 环境变量拼接，也不 fallback 到其他路径。
- 终端里必须能跑通：
kubectl version --client（有输出）、kubectl config current-context（返回目标上下文名）、kubectl get nodes（返回节点列表） - Mac 上常见权限问题：
ls -l ~/.kube/config确保当前用户有读权限；若用自签名证书，临时加insecure-skip-tls-verify: true测试 - 配置文件不在
~/.kube/config？Cmd+Shift+P →Kubernetes: Configure Kubernetes Configuration File→ 粘贴绝对路径（不能带~，末尾不能有斜杠）
kubectl 能通但资源树为空？检查命名空间、上下文、RBAC 三者是否同时生效
插件默认只拉 default 命名空间，且每次展开都发一次 kubectl get 请求。网络慢或权限不足就会卡住或显示为空。
Kubernetes Skills
下载
针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。
- 右下角状态栏必须显示类似
k8s-context: eks-prod；没显示？说明上下文没激活：点击状态栏的default可切换命名空间，想看全部资源，必须选All namespaces - 验证 RBAC：
kubectl auth can-i list pods -A必须返回yes；否则 API Server 拒绝请求，插件就拿不到任何资源 - 插件不缓存，高延迟网络下“转圈”是正常表现，不是 bug
YAML 编辑没提示、字段标红失效？缺的是 schema 绑定，不是插件开关
插件自己不校验 YAML，它靠 redhat.vscode-yaml 插件 + 外部 JSON Schema 实现补全和报错。没提示 = 没配 schema。
- 必须安装
redhat.vscode-yaml（Red Hat 官方 YAML 插件），否则连缩进折叠都异常 - 打开任意
.yaml文件，左下角语言模式必须是YAML (Kubernetes)，不是YAML或Plain Text - 在文件顶部加注释声明 schema：
# yaml-language-server: $schema=https://raw.githubusercontent.com/instrumenta/kubernetes-json-schema/master/v1.28.0-standalone-strict/all.json（版本号务必和kubectl version --short一致）
点不动「部署」按钮？插件还没真正连上集群
「部署」按钮（小火箭图标）依赖两个条件：一是 kubeconfig 路径配置正确，二是插件已显式连接到某个上下文。只配路径不连接，按钮始终灰色。
- Cmd+Shift+P →
Kubernetes: Select Context，确认列表里有可用上下文；若为空，先运行Kubernetes: Add Config File指向你的配置文件 - 点击左侧 Kubernetes 图标 → 右上角点
Connect to Cluster→ 选一个上下文，等右下角弹出 “Connected to cluster” - 此时资源树应展开，能看到
default命名空间和里面的 Pods；看不到就说明连接失败，大概率是kubeconfig权限问题或当前上下文不可达
插件不自动重连、不自动 fallback、不读环境变量、不缓存响应——它很老实，只做你明确告诉它做的事。最容易被忽略的，是「连上集群」这一步必须手动触发，而不是靠配置完就自动生效。
