skaffold 本身不提供 go 代码热重载能力，必须依赖 air 或 fresh 等进程管理器实现“改完即生效”；sync 配置需正确定义在 build.artifacts 下、路径匹配用 */.go、容器内目标路径须存在可写、entrypoint 必须 exec 启动以传递信号。
Skaffold 本身不提供 Go 代码热重载能力，它只负责文件同步和构建触发；真正实现“改完即生效”，必须靠 air 或 fresh 这类进程管理器，且配置必须对齐路径、信号和构建上下文。
skaffold dev 没反应？先看 sync 是否真生效
Skaffold 默认不会监听任意文件改动——sync 是显式开关，不是默认行为。常见错误是只写了 build，却漏掉 sync 块，或把它错放在全局层级（如 deploy 外），而它必须定义在 build.artifacts 下每个镜像项里。
-
sync路径匹配用**/*.go才能覆盖子目录，*.go只匹配根目录下的文件 - 若用 rsync（默认），容器内目标路径（如
/app）必须存在且可写：先kubectl exec -it <pod> -- ls -l /app</pod>确认权限 -
watch: true只是开启监听，是否触发 rebuild/sync，取决于sync规则是否命中——改了go.mod却没在sync.watch里声明，就不会重建
Go 进程不重启？air 配置和 Dockerfile 必须咬合
Skaffold 的 sync 只拷文件，不杀进程。原生 go run main.go 无法响应文件变更，每次改完都得手动删 Pod；air 是目前最稳的解法，但它的配置和容器环境必须一致。
- Dockerfile 中需提前安装
air：RUN curl -sSfL https://raw.githubusercontent.com/cosmtrek/air/master/install.sh | sh -s -- -b /usr/local/bin -
.air.toml里root = "."和tmp_dir = "tmp"的路径，要和 Skaffoldsync.dest目标（如/app）保持一致 - ENTRYPOINT 必须用
exec方式启动，否则 SIGTERM 传不到air进程：ENTRYPOINT ["sh", "-c", "exec air -c .air.toml"] - 别在 Dockerfile 里写
CMD go run main.go—— 编译慢、不可缓存、无法热重载
skaffold.yaml 的 context 错了，build 就会静默失败
Go 构建强依赖模块路径，context 不是指 Docker 构建上下文，而是 go build 查找 go.mod 的起点。填错不会报“context 错误”，而是卡在 go: go.mod file not found 或 cannot find module providing package。
- 如果项目结构是
./go.mod+./cmd/api/main.go，context: . - 如果是
./backend/go.mod+./backend/cmd/main.go，context: ./backend - 别让
skaffold init自动猜——它只扫当前目录及一级子目录，多层嵌套时务必手动指定--artifact ./backend - 加
cache: false在build.artifacts下，避免 Skaffold 复用旧镜像导致代码未更新
端口不通、503、卡在 “Waiting for deployments to stabilize…”
这不是 Skaffold 同步问题，而是 K8s 层资源未就绪，导致 Skaffold 主动暂停后续 sync 流程。它会等 Pod Ready、Service 可访问、甚至 readinessProbe 通过才继续监听。
- 先
kubectl get pods -w看是否CrashLoopBackOff：常见原因是 sync 后缺失依赖（比如 alpine 容器里运行了没加CGO_ENABLED=0的二进制） - 调试阶段可关掉就绪等待：
deploy.wait.readiness: false（Skaffold v2.10+ 支持） - Minikube 用户注意：
minikube mount和 Skaffoldsync共享挂载点时会锁死，建议换 Kind - Kind 更适配本地开发：它复用宿主机 Docker daemon，
build.local.push: false能直传镜像，不用推 registry
最容易被忽略的是：Skaffold 不处理 ConfigMap/Secret/模板变更，改了这些文件，sync 不生效，必须靠 build 重新部署整个 artifact —— 这类资源得单独写脚本 watch + kubectl apply，或用 Helm + Skaffold 的 helm deployer。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
