Dockerfile中不能用go run，因会重复编译且需Go环境；应多阶段构建：builder阶段用golang镜像go build生成静态二进制，运行阶段用distroless或alpine镜像COPY执行文件。
为什么 Dockerfile 里不能直接用 go run
开发时习惯 go run main.go，但生产镜像中这么做会导致两个问题：一是二进制没编译，每次启动都重新编译，浪费资源；二是 go run 依赖 Go 环境，而生产镜像不该打包 SDK。正确做法是用 go build 生成静态二进制，再 COPY 进精简镜像。
- 使用
go build -a -ldflags '-extldflags "-static"' -o /app/server .确保生成静态链接可执行文件 - 基础镜像优先选
gcr.io/distroless/static:nonroot或alpine:latest，避免带 shell 和包管理器的“胖镜像” - 多阶段构建必须分离构建环境和运行环境：
FROM golang:1.22-alpine AS builder→FROM alpine:latest
如何让本地开发时的热重载不破坏容器一致性
开发需要快速反馈，但 air、reflex 这类工具默认依赖宿主机二进制，放进容器后路径、权限、信号行为都可能异常。关键不是禁用热重载，而是把它约束在容器内可控范围内。
- 本地
docker-compose.yml中挂载源码到容器内，用volume映射./cmd:/app/cmd，而非只复制 - 在构建阶段安装
air：运行go install github.com/cosmtrek/air@latest，然后CMD ["air"] - 注意
air.toml中的root路径要设为容器内路径（如/app），且关闭tmp_dir自动清理，避免反复重建临时文件触发误编译
环境变量与配置怎么在 dev/prod 间安全切换
硬编码 os.Getenv("DB_HOST") 没问题，但加载顺序和默认值容易出错。Docker 不会自动注入 .env 文件内容，docker-compose up 默认只读取当前目录的 .env，且仅用于替换 compose 文件里的 ${VAR} 占位符，不传递给容器进程。
- 开发时用
docker-compose.yml的environment:显式写死或引用.env（如DB_URL: ${DB_URL}） - 生产时改用
secrets或configs，通过docker stack deploy注入，避免敏感信息出现在镜像层或日志中 - Go 代码里统一用
github.com/spf13/viper，按顺序读取：命令行参数 → 环境变量 →config.yaml（挂载进容器）→ 内置默认值
网络、存储、时区这些“隐形差异”怎么对齐
本地 Docker Desktop 和 Kubernetes 集群的 DNS 解析、/etc/hosts 行为、/proc/sys/net 参数都不一样；time.Now() 在 Alpine 容器里默认是 UTC，但某些数据库驱动或日志库会隐式依赖本地时区。
立即学习“go语言免费学习笔记（深入）”；
- 所有容器统一加
ENV TZ=UTC，并在启动前运行RUN apk add --no-cache tzdata && cp /usr/share/zoneinfo/UTC /etc/localtime - 数据库连接字符串里显式指定
timezone=utc（PostgreSQL）或parseTime=true&loc=UTC（MySQL），别依赖系统默认 - 用
host.docker.internal做本地服务发现只适用于 Docker Desktop，生产应改用服务名（K8s headless service 或 Consul DNS）
FROM golang:1.22-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o server . FROM alpine:latest RUN apk --no-cache add ca-certificates tzdata ENV TZ=UTC WORKDIR /root/ COPY --from=builder /app/server . CMD ["./server"]
最常被忽略的是：开发用 docker-compose up 启动的容器默认是 bridge 网络，而生产 K8s Pod 是 hostNetwork 或 CNI 插件网络，端口映射、健康检查探测路径、就绪探针超时阈值这些细节，必须在 CI 构建阶段用 curl -f http://localhost:8080/healthz 实际验证，不能只靠本地跑通。
