先确认kubectl和kubeconfig是否真可用：需终端执行kubectl version --client（≥1.18）、kubectl config current-context（输出目标上下文名）、kubectl get nodes -a（成功返回节点列表），并确保~/.kube/config权限正确、语言模式设为kubernetes、显式执行connect to cluster命令。
插件连不上集群？先确认kubectl和kubeconfig是否真可用
VSCode Kubernetes 插件根本不会自己连接集群，它只是调用你本地的 kubectl。95% 的“连不上”问题，根源在 CLI 层——不是插件配置错，而是 kubectl 本身跑不通。
- 终端执行
kubectl version --client，必须输出类似Client Version: version.Info{Major:"1", Minor:"28"...}；若报 command not found 或版本低于 1.18，插件直接退出 - 运行
kubectl config current-context，输出必须是你想连的那个上下文名（如minikube或gke-prod），不能是空或default（除非你真用 default） - 执行
kubectl get nodes -A，必须返回节点列表；若报Unable to connect to the server，说明网络、证书或权限任一环节断了 -
~/.kube/config文件权限要对：macOS/Linux 上ls -l ~/.kube/config显示当前用户有读权限；Windows 上右键属性 → “安全”标签页确认当前用户有读取权限，且文件未被标记为“来自互联网”
YAML 编辑没提示？语言模式和 Schema 必须手动设对
打开一个 deployment.yaml，右下角显示的是 YAML 或 YAML (Kubernetes)？那就还没生效。只有纯 Kubernetes 模式才触发字段补全、类型校验和资源树联动。
Kubernetes Skills
下载
针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。
- 点击右下角语言模式标签 → 选择
Change Language Mode→ 输入kubernetes并回车；若列表里没有Kubernetes，说明redhat.vscode-yaml插件没装或没启用 - 输入
apiVersion:后应立刻弹出apps/v1、batch/v1等建议；没反应 = YAML 语言服务器没加载成功 - 不要依赖自动识别——VSCode 不会根据文件内容猜语言模式，必须手动切换
- 如需精准校验（比如 CRD 或旧版 API），在
settings.json中加："kubernetes.schemaLocation": "https://raw.githubusercontent.com/instrumenta/kubernetes-json-schema/master/v1.28.0-standalone-strict/all.json"，版本号按集群实际 API 版本调整
右键 Apply 按钮灰色？Connect to Cluster 是显式动作
资源树为空、小火箭按钮灰色、右键菜单不出现，大概率卡在“连接”这一步。VSCode 不会自动连接，必须手动触发一次 Connect to Cluster。
- 按
Ctrl+Shift+P（Win/macOS）打开命令面板，输入并执行Kubernetes: Connect to Cluster -
Kubernetes: Select Context只改本地记忆，不发请求；它不会让资源树刷新，也不会激活部署按钮 - 连接成功后，右下角状态栏必须显示 context 名（如
aws-eks-prod），鼠标悬停能看到 server 地址；此时展开资源树才应看到命名空间列表 - 若仍为空，检查
kubectl auth can-i list pods -A是否返回yes；返回no表示 RBAC 权限不足，插件无法拉取资源
Apply 失败或日志打不开？背后全是 kubectl 进程调用
插件所有操作（Apply、View Logs、Port Forward）本质都是后台执行 kubectl 命令。失败时不是插件 bug，而是 CLI 执行层面出了问题。
- 点击 Pod 的
View Logs报错command 'kubectl.logs' not found→ 插件找不到kubectl，检查 PATH 和可执行权限 -
Port Forward失败报error: unable to listen on port→ 端口被占，插件不会自动换端口，得自己杀掉冲突进程 - VSCode 关闭后，
kubectl port-forward进程不会自动终止，得手动pkill -f "port-forward"清理，否则下次点又起新进程 - 资源编辑后点 Apply，实际执行的是
kubectl apply -f /path/to/file.yaml；若报错error: unable to recognize...，通常是apiVersion或kind写错，或集群没启用对应 group/version
kubectl 能否以当前用户身份、用当前 kubeconfig、访问当前 context 对应的 server——所有插件功能都建立在这层 CLI 可用性之上。
