多阶段编译通过分离构建与运行环境，先在完整go环境中编译程序，再将二进制文件复制到alpine或scratch等极小镜像中运行，避免携带编译器、源码等冗余内容，显著减小镜像体积并提升安全性。
用 golang 构建最小容器镜像，关键在于避免将不必要的构建工具和依赖打入最终镜像。多阶段编译是实现这一目标的核心手段。通过在 dockerfile 中使用多个 FROM 指令，可以在一个阶段完成编译，只将生成的可执行文件复制到一个极简的基础镜像中运行，从而大幅减小镜像体积。
为什么需要多阶段编译？
Go 程序虽然能静态编译成单个可执行文件，但构建过程需要 Go 编译环境（如 golang:1.21 镜像），这类镜像通常几百 MB。如果直接用它作为运行环境，会包含编译器、源码、模块缓存等无用内容。多阶段编译允许你：
- 在构建阶段使用完整的 Go 环境编译程序
- 在运行阶段使用 alpine 或 scratch 这类轻量基础镜像
- 只复制编译好的二进制文件，不带任何构建依赖
标准多阶段构建示例
以下是一个典型的多阶段 Dockerfile：
FROM golang:1.21 AS builder
WORKDIR /app
copy . .
RUN go build -o myapp .
FROM alpine:latest
RUN apk –no-cache add ca-certificates
WORKDIR /root/
COPY –from=builder /app/myapp .
CMD [“./myapp”]
第一阶段使用 golang:1.21 编译出二进制文件 myapp。第二阶段基于 alpine:latest，仅安装运行所需的 CA 证书，并复制可执行文件。最终镜像通常在 10-20MB 左右。
立即学习“go语言免费学习笔记（深入）”；
进一步优化：使用 scratch 镜像
若程序不依赖外部库（如 DNS 解析、ssl 证书等），可使用 scratch——一个完全空白的镜像。这能将镜像压缩到极致：
FROM golang:1.21 AS builder
WORKDIR /app
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o myapp .
FROM scratch
COPY –from=builder /app/myapp /myapp
CMD [“/myapp”]
关键点：
这样生成的镜像仅包含二进制文件本身，通常小于 10MB，适合 kubernetes 等对启动速度和网络传输敏感的场景。
添加必要运行时支持
若使用 alpine，可能需要额外处理 DNS 或证书问题。例如：
- 确保 go build 时使用 netgo 构建网络包：添加 -tags netgo
- Alpine 使用 musl libc，某些 Go 程序行为可能略有不同，建议测试验证
- 可添加非 root 用户运行以提升安全性：
FROM alpine:latest
RUN adduser -D -s /sbin/nologin appuser
USER appuser
COPY –from=builder /app/myapp .
CMD [“./myapp”]
基本上就这些。多阶段编译结合静态编译，是 Go 服务容器化的最佳实践。既能保证构建环境完整，又能输出最小运行镜像，安全且高效。
