skaffold watch 无反应需检查 sync 配置是否正确定义在 artifact 级别、路径匹配是否正确、容器内目标路径是否存在且可写，并确认使用 air/fresh 等热重载工具而非原生 go run。
Skaffold watch 没反应？检查 skaffold.yaml 的 sync 配置是否生效
Skaffold 默认不会自动同步任意文件改动到容器，必须显式声明哪些文件变更触发重建或热重载。常见错误是只写了 build 节点，却漏掉 sync 或写错路径匹配规则。
-
sync必须在deploy之后的 artifact 级别定义，不是全局配置 - 路径用
**/*.go可匹配子目录，但*.go只匹配根目录下的 Go 文件 - 若用
rsync同步（默认），容器内目标路径需存在且可写，否则静默失败——建议先kubectl exec -it <pod> -- ls -l /app</pod>确认路径 - 使用
watch: true是前提，但不等于自动 sync；watch 只触发 rebuild/sync 判定，实际行为由sync规则决定
Go 进程不重启？确认 dev 模式下用了 air 或 fresh 而非原生 go run
Skaffold 的 sync 只负责文件拷贝，Go 代码变更后能否热重载，取决于容器内进程是否监听文件变化并主动 reload。原生 go run main.go 不具备该能力，每次 sync 后仍需手动 kill + restart。
- 推荐在 Dockerfile 中用
air：安装curl -sSfL https://raw.githubusercontent.com/cosmtrek/air/master/install.sh | sh -s -- -b $(go env GOPATH)/bin，然后 CMDair -c .air.toml -
.air.toml中root = "."和tmp_dir = "tmp"需与 Skaffold sync 的目标路径一致（如/app） - 若用
fresh，注意其默认忽略vendor/和tmp/，而 Skaffold sync 可能覆盖这些目录，导致 fresh 误判无变更
skaffold dev 卡在 “Waiting for deployments to stabilize…” 怎么办
这通常不是 Skaffold 本身的问题，而是 K8s 资源未就绪导致 Skaffold 暂停后续 sync 流程。它会等 Pod Ready、Service 可访问、甚至健康检查通过才继续监听文件变化。
- 检查 Pod 是否 CrashLoopBackOff：
kubectl get pods -w，常见原因是 sync 后依赖未安装（如缺失CGO_ENABLED=0编译的二进制，却在 alpine 容器里运行） - 临时跳过等待：加
--port-forward=false --rpc-http-port=0减少干扰，聚焦 sync 本身是否工作 - 若用
minikube，确保minikube mount未与 Skaffold sync 冲突——二者都试图操作同一挂载点时会锁死 - Skaffold v2.10+ 支持
wait: { readiness: false }在 deploy 节点中关闭就绪等待，适合调试阶段快速迭代
修改模板或 configmap 后没同步？Skaffold 默认不处理非 artifact 文件
skaffold.yaml 的 sync 只作用于构建产物（即 artifact 对应的镜像内容），K8s 清单（deployment.yaml）、ConfigMap、Secret 等属于 deploy 阶段，Skaffold 不 watch 它们——改了也不会触发 apply。
立即学习“go语言免费学习笔记（深入）”；
- 要实现清单热更新，得用
skaffold dev --trigger=polling并配合deploy.kubectl.manifests指向本地路径，但 polling 有延迟，且不感知文件内容差异 - 更可靠的做法：把 ConfigMap 做成 volumeMount，再让 Skaffold
sync到对应路径（例如/config），Go 程序自己监听该目录变化 reload 配置 - 注意：ConfigMap 更新后 K8s 不自动注入新内容到运行中 Pod，除非用
subPath+restartPolicy: Always配合 initContainer 触发重启——这已超出 Skaffold 能力范围
Skaffold 的 sync 机制本质是“文件搬运工”，它不管你的 Go 进程怎么活、怎么读配置、怎么响应变化。真正决定开发体验流畅度的，是容器内那层 reload 工具和程序自身的热加载设计。很多人卡住，不是因为 Skaffold 配错了，而是忘了容器里跑的其实是个“裸 Go 进程”。
