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 等服务，并配置网络与卷：

• 使用 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 环境。