
本文介绍一种无需频繁重建镜像即可实时编译、热重载并运行 Go 代码的 Docker 持续开发方案,重点解决传统 docker-compose build && up 流程导致的迭代延迟问题。
本文介绍一种无需频繁重建镜像即可实时编译、热重载并运行 go 代码的 docker 持续开发方案,重点解决传统 `docker-compose build && up` 流程导致的迭代延迟问题。
在基于 Docker Compose 的本地 Go 开发中,每次修改代码后执行 docker-compose build && docker-compose up 不仅耗时,还中断运行环境、丢失内存状态,严重拖慢开发节奏。理想的工作流应支持:源码变更自动检测 → 即时编译 → 进程热重启(不重建容器),同时保持容器内运行环境与生产一致。
虽然答案提到了 Wercker 的 wercker dev(含 internal watch 和 reload: true),但需注意:Wercker 已于 2019 年正式停止服务,该方案已不可用且不推荐用于新项目。当前更主流、轻量、可维护的替代方案是结合 air(Go 热重载工具) + 多阶段构建 + 绑定挂载(bind mount) 实现真正的“零镜像重建”开发:
✅ 推荐实践:air + Docker Compose 绑定挂载
-
在 go.mod 项目根目录添加 air.toml 配置(启用自动构建与重启):
root = "." tmp_dir = "tmp"
[build] cmd = "go build -o ./bin/app ." bin = "./bin/app" delay = 1000 exclude_dir = ["tmp", "vendor", ".git"] include_ext = ["go", "mod", "sum"]
[watch] exclude_dir = ["tmp", "vendor"]
2. **Dockerfile(多阶段,兼顾开发与生产)**: ```Dockerfile # 构建阶段(仅用于生成二进制) 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 /bin/app . # 运行阶段(极简基础镜像) FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /bin/app . CMD ["./app"]
-
docker-compose.yml(开发模式启用源码挂载 + air):
version: '3.8' services: app: build: . # 关键:将本地源码实时挂载到容器内,覆盖二进制路径(供 air 使用) volumes: - .:/app - ./tmp:/app/tmp # air 临时文件目录 working_dir: /app command: sh -c "go install github.com/cosmtrek/air@latest && air" ports: - "8080:8080" environment: - GOPROXY=https://proxy.golang.org,direct
✅ 启动命令:docker-compose up --build
✅ 效果:修改任意 .go 文件 → 容器内 air 自动触发 go build → 重启进程 → 无需 docker-compose build,容器 ID 和网络状态全程保持。
⚠️ 注意事项
- 禁止在生产镜像中安装 air 或保留源码:上述 volumes 仅用于开发;上线前应使用 docker-compose -f docker-compose.prod.yml up(无挂载、无 air,直接运行静态二进制)。
- Windows/macOS 用户注意文件系统性能:Docker Desktop 的文件挂载可能存在延迟,可调高 air.toml 中 delay 值(如 3000)避免重复触发。
- 替代工具选项:除 air 外,fresh、gin(需适配 Go Modules)亦可,但 air 对模块支持最完善、配置最简洁。
该方案完全复用原有 Docker Compose 结构,零依赖外部 SaaS 服务,安全可控、启动快、调试友好,是当前 Go + Docker 本地持续开发的事实标准实践。


















