多阶段构建通过隔离构建与运行阶段，仅将最终二进制文件复制到精简基础镜像中，实现最小层数（如alpine+copy共2层）；其本质是跳过中间层而非删除，copy --from不引入源阶段层数。
多阶段构建本身不是为了“减少层数”而设计的，而是为了解决镜像臃肿、安全风险高、体积过大等问题。但它确实能显著降低最终镜像的层数——关键在于：只保留运行必需的文件，跳过所有构建中间产物。
理解层数的本质：删不掉的快照
Docker 镜像层数由每条指令（FROM、RUN、COPY 等）产生的文件系统快照决定，不是由 RUN 条数简单相加。即使你在单阶段中用 RUN rm -rf /tmp 删除了临时文件，那一层依然存在，只是标记为“已删除”，实际空间未释放。
多阶段构建绕开了这个问题：它不尝试在一层里“擦除”，而是直接不用那些层。构建阶段的所有内容（Go 编译器、.go 源码、mod 缓存、中间对象）完全隔离在 builder 阶段，运行阶段从零开始，只 COPY 一个二进制文件。
让运行阶段真正“少层”的实操要点
最终镜像层数 = 运行阶段基础镜像层数 + 你主动添加的层数。所以控制起点最关键：
- 优先选 alpine:3.20 而非 scratch：scratch 是零层，但无 shell、无调试能力；alpine:3.20 自身仅 1 层，加上你 COPY 二进制就是 2 层，够小也够实用
- COPY --from 不增加源阶段层数：它只复制文件内容，不会把 builder 阶段的 10 层一起搬过来。这是层数不累积的核心机制
- 运行阶段避免多余指令：不要在 FROM alpine 后写 RUN apk add、RUN chmod（除非真需要）、WORKDIR 多次切换——每条都是新层。精简到只留 COPY 和 CMD 就最稳
别踩这些常见坑
很多“层数没减下来”，其实是构建失败或误操作导致运行阶段退化成单阶段：
- COPY --from=builder 写成 --from=build：阶段名拼错，Docker 找不到源阶段，会报 unknown stage name，然后可能 fallback 到隐式单阶段
- 路径写错，比如 COPY --from=builder /app/main /app，但 builder 里实际输出在 /workspace/main：构建时提示 /app not found，结果 COPY 失败，后续指令可能被跳过或出错
- 用 --from=0 这类数字索引：一旦调整 FROM 顺序，阶段编号全乱，维护性差，容易误引用
Go 项目典型安全写法（2 层运行镜像）
这个结构能稳定产出仅含 1 层基础镜像 + 1 层二进制的最终镜像：
# 构建阶段：缓存 go mod，编译静态二进制 FROM golang:1.22-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o /app/server . <h1>运行阶段：纯 Alpine，只 COPY 二进制</h1><p>FROM alpine:3.20 WORKDIR /root COPY --from=builder /app/server . CMD ["./server"] </p>
这里没有 RUN、没有 apk、没有额外文件操作——只有基础镜像层和一个 COPY 层，共两层。如果确认是纯静态链接且无需调试，把 alpine:3.20 换成 scratch，就能做到真正零层运行镜像。
