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