选择golang:1.21 镜像编写dockerfile，通过 docker-compose 挂载代码并配置ai r 实现热更新，结合。air.toml 定义构建与监听规则，启动容器后自动编译运行，支持代码修改实时生效，便于本地调试。
想在 Docker 中快速搭建 golang 开发环境？关键在于选择合适的镜像、配置好依赖和热更新机制，让开发流程顺畅。下面是一个实用且完整的搭建方法，适合本地开发调试使用。
1. 选择基础镜像并编写 Dockerfile
从官方 Golang 镜像出发，推荐使用 golang:1.21 或更高版本，确保支持最新语言特性。
在项目根目录创建Dockerfile：
FROM golang:1.21 AS builder <h1> 设置工作目录 </h1><p>WORKDIR /app</p><p><span> 立即学习 </span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">go 语言免费学习笔记（深入）</a>”；</p><h1> 拷贝 go mod 相关文件并下载依赖（利用 Docker 缓存优化构建速度）</h1><p>COPY go.mod go.sum ./ RUN go mod download</p><h1> 拷贝源码 </h1><p>COPY . .</p><h1> 构建二进制文件 </h1><p>RUN go build -o main ./cmd/main.go</p><h1> 运行阶段（可选：多阶段构建减小体积）</h1><p>FROM golang:1.21-alpine WORKDIR /app COPY --from=builder /app/main . CMD ["./main"]如果你只是用于开发，可以省略多阶段构建，直接在一个镜像里运行编译和调试。
2. 配置docker-compose.yml 实现热更新
开发时希望代码修改后自动重新编译运行，可以用 air 工具 实现热重载。
先安装 air（在容器内）：
然后创建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" <p>[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"</p><p>[log] time = false</p><p>[color] app = "yellow" build = "cyan" main = "magenta" runner = "green" watcher = "blue"</p><p>[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 -it <container_id> sh查看依赖、运行单测、手动编译都方便。
基本上就这些。整个流程清晰高效，适合日常开发使用。
