kind是go项目本地开发首选：启动快、轻量、多节点原生支持、与go test集成好，纯容器化适配mac/linux/wsl；常见问题多因docker未运行或用户无docker组权限。
用 kind 启动本地集群最省事
绝大多数 Go 项目本地开发时，kind 是首选：启动快、镜像轻、原生支持多节点、和 go test 集成顺滑。它不依赖 VirtualBox 或 Hyper-V，纯容器化，Mac/Linux/WSL 都能一跑就通。
常见错误现象：kind create cluster 卡住、报 failed to list nodes、或 kubectl get nodes 返回空——八成是 Docker 没运行，或当前用户没加入 docker 用户组。
- 先确保
docker命令可用且有权限（Linux/macOS 上执行groups看是否含docker） - 运行
kind create cluster --name my-go-env，名字别用下划线（Kubernetes DNS 不认） - 立刻验证：
kubectl cluster-info --context kind-my-go-env，看到Kubernetes control plane地址才算成功 - 如果 Go 程序要直连集群，记得设环境变量：
KUBECONFIG=$(kind get kubeconfig-path --name my-go-env)
Minikube 在 Windows 上更稳但启动慢
如果你在 Windows 原生系统（非 WSL）上开发，minikube 的 hyperv 或 wsl2 驱动通常比 kind 更少出设备权限问题，但它每次 minikube start 都要拉 ISO、启 VM、等 kubelet 就绪，耗时 1–2 分钟很常见。
容易踩的坑：minikube start --driver=docker 在某些旧版 Docker Desktop for Windows 上会失败，报 driver not found；而默认的 hyperv 驱动又要求管理员权限和开启 Hyper-V。
立即学习“go语言免费学习笔记（深入）”；
- 推荐显式指定驱动：
minikube start --driver=wsl2 --cpus=2 --memory=4096（WSL2 用户） - 启动后必须执行
minikube update-context，否则kubectl还连着旧上下文 -
minikube ip返回的是 VM 的 IP，Go 程序若用rest.InClusterConfig()没问题，但用rest.InClusterConfig()外部访问时，得用minikube service --url <svc></svc>拿服务地址
Go 程序连本地集群的三种配置方式
你的 Go 代码怎么读到集群凭据？不是所有方式都适用于本地调试场景。硬编码 ~/.kube/config 路径最常见，但 CI 或不同环境容易错位；用 in-cluster config 则只在 Pod 内有效，本地跑直接 panic。
关键区别在于：本地开发 ≠ 生产部署。别把 rest.InClusterConfig() 当默认选项，它查的是 /var/run/secrets/kubernetes.io/serviceaccount/，你本机根本没有这个目录。
- 开发时优先用
rest.InClusterConfig()的 fallback：先试os.Getenv("KUBECONFIG")，再 fallback 到clientcmd.BuildConfigFromFlags("", os.Getenv("KUBECONFIG")) - 启动 Go 程序前务必导出：
export KUBECONFIG=$(kind get kubeconfig-path --name my-go-env) - 如果用
controller-runtime，直接传mgr, err := ctrl.NewManager(ctrl.GetConfigOrDie(), ...)即可，它内部已处理了环境变量和默认路径逻辑
测试时避免误删集群资源
Go 的集成测试（比如用 envtest）常起临时控制平面，但很多人直接写 kubectl delete -f config/ 清理，结果把 kind 集群里其他项目的 CRD 或 Namespace 也干掉了。
根本原因：测试脚本没限定 namespace，或没加 label selector。本地集群资源混在一起，删起来毫无边界感。
- 所有测试 YAML 加统一 label：
test-run: $(date +%s)，清理时用kubectl delete all --all-namespaces -l test-run - 测试用的 Namespace 必须用随机名（
test-ns-+rand.String(6)），别硬写default - CI 中跑
kind测试，建议每个 job 创建独立集群：kind create cluster --name "test-$GITHUB_RUN_ID"，完事kind delete cluster --name "test-$GITHUB_RUN_ID"
本地集群不是沙盒，它和你手动操作的 kubectl 完全共享状态。一个 kubectl delete --all-namespaces 就能让半天调试白干——这事真发生过，而且不只一次。
