选择golang:1.21镜像编写Dockerfile，通过docker-compose挂载代码并配置air实现热更新，结合.air.toml定义构建与监听规则，启动容器后自动编译运行，支持代码修改实时生效，便于本地调试。
想在Docker中快速搭建Golang开发环境？关键在于选择合适的镜像、配置好依赖和热更新机制，让开发流程顺畅。下面是一个实用且完整的搭建方法，适合本地开发调试使用。
1. 选择基础镜像并编写Dockerfile
从官方Golang镜像出发，推荐使用golang:1.21或更高版本，确保支持最新语言特性。
在项目根目录创建Dockerfile：
FROM golang:1.21 AS builder设置工作目录
WORKDIR /app
立即学习“go语言免费学习笔记（深入）”；
拷贝go mod相关文件并下载依赖（利用Docker缓存优化构建速度）
COPY go.mod go.sum ./ RUN go mod download
拷贝源码
COPY . .
构建二进制文件
RUN go build -o main ./cmd/main.go
运行阶段（可选：多阶段构建减小体积）
FROM golang:1.21-alpine WORKDIR /app COPY --from=builder /app/main . CMD ["./main"]
如果你只是用于开发，可以省略多阶段构建，直接在一个镜像里运行编译和调试。
2. 配置docker-compose.yml实现热更新
开发时希望代码修改后自动重新编译运行，可以用air工具实现热重载。
先安装air（在容器内）：
go install github.com/cosmtrek/air@latest
然后创建docker-compose.yml：
version: '3.8'
services:
app:
build: .
ports:
- "8080:8080"
volumes:
- ./src:/app/src
- ./go.mod:/app/go.mod
- ./go.sum:/app/go.sum
working_dir: /app
command: >
sh -c "go mod download && air -c .air.toml"
environment:
- GOPATH=/go
注意：挂载源码目录是实现热更新的关键，这样宿主机改代码，容器内能立即看到变化。
3. 添加.air.toml配置air行为
在项目根目录创建.air.toml，定制监听规则和构建命令：
root = "." tmp_dir = "tmp"[build] args_bin = "./main" bin = "tmp/main" cmd = "go build -o ./tmp/main ./src/main.go" delay = 1000 exclude_dir = ["assets", "tmp", "vendor"] exclude_file = [] exclude_regex = ["_test.go"] include_ext = ["go", "tpl", "tmpl"] include_file = [] kill_delay = "0s"
[log] time = false
[color] app = "yellow" build = "cyan" main = "magenta" runner = "green" watcher = "blue"
[misc] clean_on_exit = true
这个配置会监听.go文件变化，自动执行构建，并启动服务。
4. 启动容器开始开发
一切准备就绪后，运行：
docker-compose up --build
你会看到类似输出：
[runner] Starting main.exe... [runner] Started pid=12 [app] Server is running on :8080 [watcher] File changed: src/handler.go [build] Building... [build] Build success [runner] Restarting main.exe...
说明热更新已生效。访问http://localhost:8080即可测试你的Go服务。
如果想进入容器内部调试，也可以执行：
docker exec -itsh
查看依赖、运行单测、手动编译都方便。
基本上就这些。整个流程清晰高效，适合日常开发使用。
