VSCode配合Minikube跑通本地K8s开发闭环的关键在于确保kubectl当前上下文为minikube、启用dashboard/metrics-server/ingress插件、应用监听地址设为0.0.0.0、手动配置匹配Minikube版本的yaml.schemas。
VSCode 配合 Minikube 能跑通本地 K8s 开发闭环，但默认配置下常卡在 YAML 校验失败、日志看不了、断点进不去这三类问题上——根本原因不是插件不行，而是 VSCode 的 Kubernetes 插件和 Minikube 的 OpenAPI spec 同步机制存在隐性错位。
Minikube context 必须是当前 kubectl 默认上下文
VSCode Kubernetes 插件启动时，会从 kubectl config current-context 对应的集群拉取 /openapi/v3 生成 YAML schema。如果你用 minikube start 启动后又手动切换过 context（比如临时切到 EKS），插件仍会尝试从旧 context 的 API Server 拉 spec，结果就是 Deployment 字段标红、spec.template.spec.containers[0].ports 被报“unknown field”，哪怕语法完全正确。
- 运行
kubectl config current-context，输出必须是类似minikube的名称，不能是空或aws-eks-staging - 若不匹配，执行
kubectl config use-context minikube，然后彻底关闭并重启 VSCode（仅重载窗口无效） - 验证：打开任意
deployment.yaml，右下角语言模式应为Kubernetes，且 Ctrl+Space 能提示replicas、imagePullPolicy等字段
Minikube 启动时要启用必要插件
Minikube 默认只启 core 组件，但 VSCode 的日志查看、端口转发、Exec 功能依赖 dashboard、metrics-server 和 ingress（后者影响 Service 类型校验）。缺一个，右键 Pod → View Logs 就会报 Error: unable to retrieve container logs。
针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。
- 启动前先执行：
minikube addons enable dashboard metrics-server ingress - 再运行
minikube start --cpus=4 --memory=8192 --driver=docker（推荐 docker 驱动，Hyper-V 在 Windows 上易触发证书信任问题） - 验证：运行
kubectl get pods -A | grep -E "(dashboard|metrics|ingress)"，所有状态应为Running
VSCode 调试需绕过 minikube 的默认网络隔离
Minikube 使用独立 Docker daemon 和内部网络，容器内服务监听 localhost:3000 时，VSCode 的 Port Forwarding 无法直接映射——因为 localhost 在容器内指向的是容器自身，而非 Minikube VM 的 loopback。
- 应用启动命令中，必须将监听地址显式改为
0.0.0.0:3000（Node.js 的--host 0.0.0.0，Go 的http.Listen(":3000")） - VSCode 中右键 Pod →
Forward Port，填入容器端口3000和本地端口（如3000），不要勾选 “Open in Browser”（该选项会尝试访问http://localhost:3000，但此时服务实际在 Minikube VM 内） - 调试器连接目标应为
localhost:3000（宿主机视角），而非容器 IP 或 Minikube IP
YAML 编辑时容易忽略的 schema 版本偏差
Minikube v1.30+ 默认提供 v1.28+ 的 OpenAPI spec，但 VSCode 插件有时会缓存旧版本或 fallback 到通用 Kubernetes schema，导致 securityContext.runAsNonRoot: true 这类较新字段被标黄警告，实际 kubectl apply 却能成功。
- 手动指定 schema：打开 VSCode 设置 → 搜索
yaml.schemas→ 添加条目："https://raw.githubusercontent.com/kinvolk/kubernetes-openapi/master/v1.28.0/openapi.json": "kubernetes" - 注意路径中的版本号要与
minikube version输出的 Kubernetes 版本对齐（如v1.28.0） - 改完后重启 VSCode，再打开 YAML 文件，右下角应显示
Kubernetes (v1.28)
Minikube 的轻量本质决定了它不会自动暴露所有调试能力；VSCode 插件也从不假设你用了哪个驱动或开了哪些插件。所有“功能失效”，几乎都指向同一个检查点：kubectl 当前上下文是否真连着正在运行的 Minikube 实例，且它的 API Server 是否返回了完整、新鲜的 OpenAPI spec。
