Go项目Docker化需多阶段构建：第一阶段用golang:1.22-alpine编译，第二阶段用alpine或scratch运行；开发用air热重载；docker-compose管理依赖服务；测试覆盖单元、集成与构建验证；注意.dockerignore排除无关文件。
在 Go 语言项目中使用 Docker 进行开发和测试，核心是让代码编译、运行、依赖管理都在容器内完成，避免“在我机器上能跑”的问题。关键不是把整个 IDE 塞进容器，而是用轻量、可复现的镜像封装构建和运行环境。
准备基础 Go 镜像（推荐多阶段构建）
不要直接基于 golang:latest 运行你的服务——它体积大、含编译工具链，不适合生产。用多阶段构建分离构建与运行环境：
- 第一阶段：用
golang:1.22-alpine编译代码，生成静态二进制文件 - 第二阶段：用
alpine:latest或scratch（极简）作为运行时基础镜像，只拷贝二进制和必要配置
这样最终镜像通常小于 15MB，启动快、攻击面小。注意 Alpine 默认用 musl libc，若依赖 cgo（如 SQLite、某些数据库驱动），需显式启用或改用 debian-slim 基础镜像。
本地开发时热重载（无需每次 rebuild 容器）
Docker 本身不支持热重载，但可通过挂载源码 + 容器内运行 air 或 fresh 实现类似效果：
立即学习“go语言免费学习笔记（深入）”；
- 在
Dockerfile.dev中安装air（go install github.com/cosmtrek/air@latest） - 用
docker run -v $(pwd):/app -w /app -p 8080:8080 golang:1.22-alpine sh -c "air" - 确保
.air.toml配置监听./...并忽略vendor/和tmp/
这种方式跳过镜像构建步骤，适合编码调试；但注意：容器内 GOPATH 和模块路径要与宿主机一致，建议统一关闭 GO111MODULE=on 并使用 go mod。
用 docker-compose 管理依赖服务（如 PostgreSQL、Redis）
Go 程序常需连接外部服务。用 docker-compose.yml 统一声明依赖，比手动 docker run 更可靠：
- 定义
db:服务，暴露5432，挂载初始化 SQL 到/docker-entrypoint-initdb.d/ - Go 应用通过服务名（如
db:5432）连接，Docker 内置 DNS 自动解析 - 添加
depends_on+ 自定义健康检查（如curl -f http://db:5432/health）避免应用启动早于 DB 就绪
测试时可额外启动一个 test-db 服务，隔离测试数据，避免污染开发库。
编写可验证的测试容器化流程
CI/CD 或本地一键测试，应覆盖单元测试、集成测试、构建验证：
- 写一个
test.sh：先go test -v ./...，再docker build -t myapp:test .，最后docker run --rm myapp:test /app/myapp --version - 用
docker buildx bake管理多平台构建（如 linux/amd64 + linux/arm64） - 对 HTTP 服务，加简单 curl 测试：
docker run -d --name app-test -p 8080:8080 myapp:test，然后curl -f http://localhost:8080/health
所有命令应无交互、可重复执行，失败时立即退出（set -e），便于接入 GitHub Actions 或 GitLab CI。
不复杂但容易忽略：始终在 .dockerignore 中排除 node_modules、vendor（除非你真用它）、.git 和 *.md，否则上下文过大拖慢构建。
