VSCode Kubernetes插件不部署Minikube集群，仅连接并操作已启动的本地实例；依赖kubectl、有效kubeconfig及手动触发Connect to Cluster才能加载资源树并执行日志、部署等操作。
VSCode 本身不部署 Minikube 集群，它只通过 Kubernetes 插件连接并操作你本地已启动的 minikube 实例；所有功能依赖你本机的 kubectl、有效的 kubeconfig，以及插件能否正确调用它们。
确认 minikube 和 kubectl 已就绪且互通
插件不会帮你启动或修复底层工具链。如果 minikube 没运行，或 kubectl 找不到集群，插件必然失败。
- 终端执行
minikube status，输出应为host: Running、kubelet: Running、apiserver: Running - 运行
kubectl config current-context，必须返回minikube（不是空、不是其他名字） - 运行
kubectl get nodes -A，应成功列出minikube节点；若报Unable to connect to the server，说明 minikube 服务未响应或证书失效 - Windows + WSL2 用户特别注意：
kubectl必须能从 VSCode 启动的终端中直接调用；若kubectl只装在 WSL2 内，而 VSCode 运行在 Windows 主系统，请改用Remote-WSL扩展打开项目，否则插件完全找不到命令
让 Kubernetes 插件读到 minikube 的 kubeconfig
插件默认只认 $HOME/.kube/config，而 minikube 每次启动会自动更新这个文件——但如果你手动改过路径、或用 minikube --config 指定了配置，插件就可能漏掉。
- 运行
minikube update-context确保上下文写入默认 config - 检查
kubectl config view --minify --output='jsonpath={.clusters[0].cluster.server}'是否返回类似https://192.168.49.2:8443的地址（而非 localhost 或 127.0.0.1） - VSCode 设置里搜
kubernetes.configPath，确保值是绝对路径，例如/Users/you/.kube/config（macOS/Linux）或C:\Users\you\.kube\config（Windows），末尾不能带斜杠 - Mac 用户若用 Homebrew 安装 minikube，有时证书被系统标记为“不受信”，需手动双击
~/.minikube/ca.crt导入钥匙串并设为“始终信任”
强制插件识别 YAML 并连接 minikube 上下文
即使配置全对，插件也不会自动加载资源树——它不主动轮询，也不默认启用 Kubernetes 语言模式。
- 打开任意
deployment.yaml，右下角语言模式必须显示Kubernetes；若显示YAML，点击它 →Configure Language Specific Settings→ 加入："kubernetes": { "editor.suggest.snippetsPreventQuickSuggestions": false } - 保存后，按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）→ 输入Change Language Mode→ 手动选Kubernetes - 点击左侧
Kubernetes图标 → 顶部资源树右上角点Connect to Cluster→ 明确选择minikube上下文；仅用命令面板里的Kubernetes: Select Context不触发重连 - 连接成功后，右下角状态栏应显示
minikube，鼠标悬停能看到 server 地址；此时展开资源树，default命名空间下应开始加载 Pods、Services 等节点
验证部署与日志功能是否真正可用
能看见资源树 ≠ 能执行操作。很多用户卡在“右键 Pod → View Logs 无反应”或“Deploy YAML 报错 command 'kubectl.logs' not found”，本质是插件没打通 kubectl 调用链。
- 右键一个正在运行的 Pod →
View Logs，窗口应弹出并实时刷新；若报错command 'kubectl.logs' not found，说明插件没找到kubectl可执行文件，需检查 PATH 或重启 VSCode（从终端启动：code） - 右键 YAML 文件 →
Deploy YAML to Kubernetes，应触发kubectl apply -f；若失败，看 VSCode 输出面板中Kubernetes标签页的原始错误，常见如error: You must be logged in to the server（证书过期）或Forbidden（RBAC 权限不足） - 终端运行
kubectl auth can-i create deployments -n default，返回yes才代表权限足够；minikube 默认给minikube上下文的用户 full admin 权限，若返回no，大概率是上下文没切对或 config 被覆盖
最容易被忽略的是：插件不缓存连接状态，也不自动重试。每次 VSCode 重启、每次切换工作区、甚至某些扩展更新后，都得手动点一次 Connect to Cluster；右下角 context 名称消失，就是断连信号，别指望它自己恢复。
