用 Docker Compose 搭建 Golang 开发环境的核心是通过 YAML 定义 go-app、PostgreSQL 和 Redis 服务，实现隔离、可复现的本地开发环境；需注意 build 配置、depends_on 与重试逻辑、服务间网络地址（如 postgres）、热重载方案（air/nodemon）、调试（dlv）、权限及健康检查等细节。
用 Docker Compose 搭 Golang 开发环境，核心是把 Go 服务、数据库、缓存等组件用 YAML 定义好，一键拉起隔离、可复现的本地环境。不需要在本机装一堆依赖，也不用担心“在我机器上是好的”问题。
基础结构：一个典型的 go-app + postgres + redis 组合
大多数 Web 服务需要后端（Go）、持久化（PostgreSQL）和缓存（Redis）。Docker Compose 把它们组织成一个项目：
-
go-app：基于 golang:1.22-alpine 或官方镜像，挂载源码、编译并运行（推荐用
go run热加载或用air） -
postgres：用官方
postgres:15镜像，通过 volume 持久化数据，暴露 5432 端口供 Go 连接 -
redis：用
redis:7-alpine，默认端口 6379，同样支持 volume 持久化
docker-compose.yml 关键配置要点
注意几个易错细节：
- Go 服务要用
build而不是image，指向本地Dockerfile；开发时建议加volumes实时同步代码 - 设置
depends_on保证数据库先启动，但要配合 Go 应用里的重试逻辑（Docker 不等容器 ready 就启动依赖项） - 数据库连接地址写成
postgres://user:pass@postgres:5432/dbname?sslmode=disable—— 主机名用 service 名（postgres），不是localhost - 加
restart: unless-stopped和healthcheck（尤其对 DB）能让环境更稳
开发流程：热重载 + 日志 + 调试怎么搞
纯 go run main.go 在容器里不支持自动重启。推荐两种轻量方案：
从 Git 仓库历史中彻底删除文件
下载
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
立即学习“go语言免费学习笔记（深入）”；
- 用
air：在 Go 容器里go install github.com/cosmtrek/air@latest，然后command: air -c .air.toml，配好监听目录和构建命令 - 或者用
nodemon思路改写：监听**/*.go，触发go build -o app && ./app - 查日志统一用
docker compose logs -f go-app，加--tail=50快速看最近几行 - 调试：在容器里暴露
dlv端口（如2345:2345），用 VS Code 的dlv-dap扩展 attach 连接即可
常见坑与绕过方式
刚上手容易卡在这几处：
-
Go 编译报 “cannot find module”：检查
go.mod是否在 volume 挂载路径下，且WORKDIR设置正确；别把go mod download放到每次启动都跑的 CMD 里 -
Postgres 启动慢 / 连不上：加
healthcheck并在 Go 里用pgxpool.ConnectConfig配置MaxRetries: 10，避免启动就 panic -
文件权限问题（尤其 macOS）：Alpine 镜像 UID 默认是 0，而宿主机挂载的代码可能是 501，加
user: "1001:1001"或在 Dockerfile 里addgroup -g 1001 -f app && adduser -S app -u 1001 -
网络不通：确认 Go 服务监听
0.0.0.0:8080而不是127.0.0.1:8080，否则外部容器访问不到
基本上就这些。不复杂但容易忽略细节，搭好一次，后续新项目复制改改就能用。
