Go项目用Docker Compose搭建本地开发环境需定制golang:1.22镜像安装air热重载，挂载源码与.air.toml，编排postgres/redis等依赖服务，应用通过服务名而非localhost连接，并通过环境变量动态配置。
在 Go 项目开发中，用 Docker Compose 搭建本地开发容器环境，能统一依赖、隔离环境、快速复现问题。核心思路是：用 go 官方镜像作为基础开发环境，挂载源码、启用热重载（如 air 或 fresh），再通过 Compose 编排数据库、缓存等依赖服务。
准备 Go 开发镜像（支持热重载）
不建议直接用 golang:alpine 做开发镜像——缺少构建工具链和调试依赖。推荐基于 golang:1.22（或你项目实际版本）定制 Dockerfile：
- 安装
air（轻量热重载工具）：go install github.com/cosmtrek/air@latest - 设置工作目录为
/app，并复制go.mod和go.sum提前缓存依赖 - 暴露项目端口（如
8080），并声明非 root 用户（安全最佳实践）
示例 Dockerfile.dev：
FROM golang:1.22 RUN go install github.com/cosmtrek/air@latest WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . USER 1001:1001 EXPOSE 8080 CMD ["air", "-c", ".air.toml"]
编写 docker-compose.yml 编排服务
根目录下创建 docker-compose.yml，定义 app（Go 服务）、postgres、redis 等服务，并配置网络与卷：
立即学习“go语言免费学习笔记（深入）”；
- 使用
build指向自定义 Dockerfile，而非预构建镜像 - 用
volumes挂载本地代码到容器内，实现实时同步；同时挂载.air.toml配置文件 - 用
depends_on声明启动顺序（仅控制容器启停，不保证服务就绪） - 为数据库添加
initdb初始化脚本支持（通过volumes挂载./init.sql:/docker-entrypoint-initdb.d/init.sql）
关键片段示例：
services:
app:
build:
context: .
dockerfile: Dockerfile.dev
volumes:
- .:/app
- ./air.toml:/app/.air.toml
ports:
- "8080:8080"
environment:
- DB_HOST=postgres
- REDIS_ADDR=redis:6379
depends_on:
- postgres
- redis
postgres:
image: postgres:15-alpine
environment:
POSTGRES_DB: myapp
POSTGRES_USER: dev
POSTGRES_PASSWORD: devpass
volumes:
- pgdata:/var/lib/postgresql/data
- ./init.sql:/docker-entrypoint-initdb.d/init.sql
redis: image: redis:7-alpine command: redis-server --appendonly yes volumes:
- redisdata:/data
volumes: pgdata: redisdata:
适配 Go 应用连接容器服务
Go 代码中不要硬编码 localhost:5432 —— 容器内需通过服务名访问。例如：
- 数据库连接字符串应为
host=postgres port=5432 user=dev password=devpass dbname=myapp sslmode=disable - Redis 地址设为
redis:6379，由 Docker 内置 DNS 解析 - 使用
os.Getenv读取环境变量，避免配置泄漏
建议封装一个 config.Load() 函数，在启动时校验必需环境变量，缺失则 panic 并提示，便于快速定位配置问题。
启动与日常开发流程
执行 docker-compose up --build 启动全部服务。air 会监听文件变化并自动 rebuild + restart。
- 日志查看：
docker-compose logs -f app - 进入容器调试：
docker-compose exec app sh（注意用户权限，可能需加-u root） - 数据库管理：
docker-compose exec postgres psql -U dev myapp - 热重载失效？检查
.air.toml中的watch.regexes是否覆盖了新文件类型（如.sql或.yaml）
若需运行测试或生成命令，可临时用 docker-compose run --rm app go test ./...，完全复现 CI 环境。
