根本原因是Minikube未启动或Skaffold未对齐其Docker环境；需先运行minikube status验证状态，再用--driver=docker启动并执行eval $(minikube docker-env)，Go程序访问Service时须用minikube ip+NodePort而非localhost。

GoLand连不上Minikube里的Pod：根本不是IDE配置问题

现象是点击「Debug」后卡住、超时，或报 connection refused、Failed to connect to cluster。这不是GoLand没配对，而是Minikube压根没跑起来，或者Skaffold没对齐它的Docker环境。

• 先手动执行 minikube status —— 如果显示 Stopped 或 Invalid，GoLand再怎么配都白搭
• macOS Sequoia（15+）必须用 minikube start --driver=docker，hyperkit 已被弃用
• Windows用户别折腾Hyper-V，开Docker Desktop后直接跑上面那条命令就行
• 启动成功后，立刻执行 eval $(minikube docker-env)，否则GoLand调用Skaffold构建的镜像只会存在宿主机Docker里，Minikube根本看不见

GoLand里调试Go服务：别在本地IDE里直接跑main.go

你在GoLand里点运行的 main.go 是宿主机进程，和Minikube虚拟机网络完全隔离。硬写 http://localhost:30080 必然失败，因为Service监听的是Minikube虚拟机IP，不是你本机的localhost。

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 查真实地址：minikube ip（比如返回 192.168.49.2）
• 查NodePort：kubectl get service my-service -o jsonpath='{.spec.ports[0].nodePort}'
• 拼出可访问地址：http://192.168.49.2:30080，这才是你的Go程序该请求的目标
• Service类型必须是 NodePort 或 LoadBalancer（配合 minikube tunnel），ClusterIP 只能在Pod内访问

用GoLand附加临时容器调试正在运行的Pod

不需要重启Pod，也不用改代码，就能进容器里查网络、看日志、抓包——这是最接近生产排查的方式。

• 打开 Services 工具窗口（View → Tool Windows → Services 或按 Alt+8）
• 展开Pod列表，右键目标Pod → Temporary Debug Container → Attach BusyBox
• GoLand会自动执行 kubectl debug 命令，启动一个带 /bin/sh 的BusyBox容器并附着到Pod
• 控制台自动打开，可直接运行 netstat -tuln、curl http://localhost:8080/healthz、ls /app 等命令
• 如果需要更重的调试环境（比如有 gdb 或 dlv），选 Attach Custom，填入自定义镜像和可执行路径

skaffold.yaml里image名写错：GoLand调试永远拉不到镜像

Skaffold默认把镜像build出来后直接交给Minikube的Docker daemon用，不推远程registry。但如果你在 skaffold.yaml 里写了带域名的镜像名，它就会试图push，而Minikube里根本没有对应registry，结果就是Pod卡在 ImagePullBackOff，GoLand连不上。

• image: 字段必须是纯名字，不含斜杠和域名，例如写 myapp，而不是 docker.io/myapp 或 localhost:5000/myapp
• 确保 build.artifacts[].context 指向含 Dockerfile 的目录，且该Dockerfile支持多阶段构建（推荐 golang:alpine 构建 + scratch 运行）
• 别手动指定 tagPolicy，dev模式下默认用 sha256，改了反而容易导致缓存失效或部署不更新

GoLand调试Minikube里的Go服务，关键不在IDE设置本身，而在网络可达性、镜像上下文对齐、以及是否理解Pod与宿主机是两个独立网络空间。最容易被忽略的，是每次新开终端后忘记重新执行 eval $(minikube docker-env) —— 这一步漏掉，Skaffold构建的镜像就永远进不了Minikube。