Go-Zero项目需用golang:1.23-alpine镜像构建，设GOPROXY、CGO_ENABLED=0、GOOS=linux；用BuildKit缓存加速mod下载；通过多阶段构建将镜像压至15MB内。
准备基础构建镜像
Go-Zero项目必须在具备Go编译能力的环境中完成二进制构建，Docker中不能直接用alpine等精简镜像编译源码，否则会因缺失go工具链而失败。
拉取官方golang:1.23-alpine镜像作为构建阶段基础：【必须使用带-alpine后缀的镜像，非debian系，否则后续多阶段COPY会因libc不兼容报错】
执行命令：docker pull golang:1.23-alpine
配置构建阶段环境变量
进入Dockerfile构建阶段时，需显式声明关键环境变量，否则go mod download可能因代理失效或CGO_ENABLED默认开启导致构建中断。
在builder阶段写入以下三行：
ENV GOPROXY https://goproxy.cn,direct
ENV CGO_ENABLED 0
ENV GOOS linux
注意：CGO_ENABLED=0是强制要求，Go-Zero服务通常不依赖C扩展，设为1会导致alpine下编译失败且镜像体积暴增。
优化依赖下载与构建速度
避免每次构建都重复下载mod，利用Docker BuildKit的cache mount机制加速：
在RUN go mod download指令前添加挂载声明：
RUN --mount=type=cache,target=/go/pkg/mod/ go mod download -x
接着执行编译命令：
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /app/service ./service/api/main.go
这一步耗时从分钟级压缩到秒级，尤其在CI/CD流水线中效果显著——没有挂载缓存时，每次都要重新fetch全部module。
分离构建与运行阶段
第一步：用golang:1.23-alpine构建出静态二进制文件；
第二步：切换至alpine:3.20空白镜像；
第三步：仅COPY上一阶段生成的二进制和配置文件；
第四步：设置工作目录并声明启动命令。
这种两阶段结构让最终镜像体积稳定控制在15MB以内，若合并为单阶段，镜像将超过400MB——因为golang镜像自带完整编译工具链和源码缓存。
COPY --from=0 /app/service /app/service
COPY --from=0 /app/etc /app/etc
EXPOSE 8888
ENTRYPOINT ["./service", "-f", "etc/service.yaml"]
