使用多阶段构建分离编译与运行环境，第一阶段基于golang:1.22-alpine静态编译Go应用，第二阶段通过scratch或alpine镜像仅保留二进制文件，禁用CGO避免动态依赖，最终镜像体积可控制在8–30MB；配合.dockerignore过滤无关文件，CI中前置go test提升可靠性，生产使用不可变镜像原则，调试时可临时替换为distroless非root镜像。
用 Docker 搭建 Golang 容器化构建环境，核心是分离构建与运行阶段，利用多阶段构建减小镜像体积、提升安全性。不需要在最终镜像里装 Go 编译器和源码，只保留静态编译好的二进制文件即可。
准备一个可编译的 Go 项目
确保项目结构规范，包含 go.mod 文件（推荐 Go 1.12+）。例如：
- 项目根目录下执行 go mod init example.com/myapp
- 写个简单 main.go，能正常 go run . 启动
- 建议禁用 CGO（CGO_ENABLED=0），避免动态链接依赖
编写多阶段 Dockerfile
典型写法分两步：构建阶段用 golang:alpine 镜像编译，运行阶段用 scratch 或 alpine 做基础镜像。
- 第一阶段以 golang:1.22-alpine 为 base，复制 go.mod 和源码，执行 go build -a -ldflags '-extldflags "-static"' -o /app/myapp .
- 第二阶段用 scratch（极简）或 alpine:latest（需调试时），把上一阶段生成的二进制拷过去
- 设置工作目录、暴露端口、声明启动命令，如 CMD ["/app/myapp"]
构建并验证镜像
在项目根目录执行：docker build -t my-go-app .
立即学习“go语言免费学习笔记（深入）”；
- 用 docker images 查看镜像大小——理想情况在 8–15MB（scratch）或 20–30MB（alpine）
- 运行测试：docker run -p 8080:8080 my-go-app，再 curl localhost:8080 确认服务响应
- 进容器检查：docker run -it --rm my-go-app ls -l /app/，确认只有二进制，无 .go 或 go.mod
进阶建议：适配 CI/CD 与本地开发
让构建更稳定、易维护：
- 在 .dockerignore 中排除 /node_modules、**/*.md、testdata 等非构建所需文件
- CI 中可加 go test -v ./... 在构建前跑单元测试（放在 builder 阶段）
- 本地开发可用 docker-compose.yml 挂载代码+热重载，但生产镜像仍坚持“构建即不可变”原则
- 如需调试，临时改用 gcr.io/distroless/static:nonroot 替代 scratch，支持非 root 用户运行
基本上就这些。Golang 容器构建不复杂但容易忽略 CGO 和镜像分层细节，按多阶段 + 静态编译走，基本零踩坑。
