核心在于三点：client-go初始化须避免kubeconfig路径硬编码，资源操作须区分namespaced/non-namespaced，事件监听须正确管理context生命周期；任一出错将导致本地失败或控制器panic。
Go 语言操作 Kubernetes 的核心不在“会不会调 API”，而在于 client-go 初始化是否绕过 kubeconfig 路径硬编码、资源操作是否区分 namespaced/non-namespaced、事件监听是否正确处理 context 生命周期——这三点出错，轻则本地跑不通，重则控制器在集群里反复 panic。
client-go 初始化必须用 BuildConfigFromFlags 而非硬编码路径
很多人写测试代码时直接传死路径如 "~/.kube/config"，结果部署到容器里就报 stat /root/.kube/config: no such file or directory。Kubernetes 官方推荐方式是让 BuildConfigFromFlags 自动 fallback：
-
BuildConfigFromFlags("", clientcmd.RecommendedHomeFile)：空字符串表示不指定 master URL，自动从 kubeconfig 推导；RecommendedHomeFile是跨平台路径（Linux/macOS 是~/.kube/config，Windows 是%USERPROFILE%\.kube\config） - 在 Pod 里运行时，更推荐挂载
ServiceAccount的 token 和 ca.crt，此时应改用rest.InClusterConfig()，否则会因找不到 kubeconfig 失败 - 如果用了
kubebuilder或controller-runtime，它内部已封装了自动判断逻辑，不用手动切逻辑分支
clientset.CoreV1().Pods("ns") 和 clientset.CoreV1().Nodes() 的命名空间差异
看似都是 CoreV1，但 Pods("ns") 必须指定命名空间，Nodes() 却不能——这是 Kubernetes API 的设计约束，不是 client-go 的 bug。一旦写成 clientset.CoreV1().Nodes("default").List(...)，会直接 panic：nodes is not namespaced。
- namespaced 资源：Pod、Service、Deployment、ConfigMap（需带命名空间名）
- non-namespaced 资源：Node、Namespace、PersistentVolume、CustomResourceDefinition（调用时不能传命名空间参数）
- 查不准？用
kubectl api-resources --namespaced=true和--namespaced=false分别验证
监听资源变更必须用 Watch + context.WithTimeout，不能只靠 List
只调 List() 是轮询，延迟高还浪费 API Server 连接数；但裸写 Watch() 又容易卡住或泄漏 goroutine。正确姿势是：
- 用
context.WithTimeout(ctx, 5*time.Minute)包一层，避免 Watch 长连接意外 hang 死 - Watch 返回的
watch.Interface必须在 defer 里.Stop()，否则每次 Reconcile 都新建 Watch 会导致 fd 耗尽 - 收到
watch.Event后，别直接用 event.Object 断言类型——它可能是*unstructured.Unstructured，要用scheme.Convert()或 client-go 提供的 typed 转换函数
自定义资源（CRD）操作必须注册 Scheme，否则 Get/Update 报 no kind "MyApp" is registered
用 client-go 直接操作 CRD 时，光有 YAML 不够。clientset 默认只认识内置资源（Pod、Deployment 等），你的 MyApp 类型需要显式添加到 Scheme：
- 先定义 Go struct 并加上
+k8s:deepcopy-gen=package注释（用controller-gen生成 deepcopy） - 初始化 clientset 前，调用
myappv1.AddToScheme(scheme.Scheme)注册类型 - 再用
dynamicClient.Resource(schema.GroupVersionResource{...})或自定义 clientset（通过genclient生成）访问 - 漏掉
AddToScheme是最常见报错来源，错误信息里那个no kind就是指这个
真正难的不是写对第一行 BuildConfigFromFlags，而是当控制器在生产环境跑了一周后，Watch 连接悄悄断开、Scheme 注册遗漏导致某次更新静默失败、non-namespaced 资源误加命名空间——这些都不会立刻报错，但会让状态收敛彻底失效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
