多阶段构建加速云端构建的核心是分层缓存复用。通过本地磁盘、远程registry、buildkit cache mount三类缓存源适配不同场景，结合--cache-from、cache mount、精准copy和.dockerignore，显著提升ci构建效率。
多阶段构建结合缓存源加速云端构建，核心在于让每个构建阶段尽可能复用已有的、稳定的中间产物，而不是每次都从头拉取依赖或重新编译。关键不是“多阶段”本身快，而是它为缓存分层和精准复用提供了结构基础。
明确缓存源类型再选策略
云端环境里，缓存源通常有三类：本地磁盘缓存（如 CI runner 本地 /tmp/cache）、远程 registry 缓存（Docker Hub 或私有 registry 的 --cache-from）、以及 BuildKit 的外部 cache mount（如 type=cache,id=npm-cache）。不同来源适用场景不同：
- 本地缓存适合单节点、短生命周期的 runner（比如自建 VM）
- registry 缓存适合多节点、弹性伸缩的云 CI（如 GitHub Actions、GitLab Runner）
- cache mount 更适合需要跨构建保留状态的场景（如 npm 包、Go module、Cargo registry）
用 --cache-from 指定远程缓存镜像
在 CI 中启动构建时，显式传入上一次成功构建的镜像作为缓存源：
docker build --cache-from your-registry.com/app:latest --tag your-registry.com/app:dev .
配合多阶段 Dockerfile，Docker 会逐层比对远程镜像的 layer hash，命中即跳过执行。注意：必须确保基础镜像 tag 稳定（推荐用 digest 而非 latest），否则缓存键不一致直接失效。
在 Dockerfile 中启用 BuildKit 并挂载 cache
开头声明语法并启用 BuildKit：
# syntax=docker/dockerfile:1.5
然后在 builder 阶段中挂载可复用的依赖缓存：
FROM golang:1.21 AS builder
WORKDIR /app
# 挂载 Go module 缓存目录，跨构建复用
RUN --mount=type=cache,target=/go/pkg/mod \
--mount=type=bind,source=go.mod,source=go.sum,target=. \
go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o main .
这样，只要 go.mod 不变，go mod download 这一步几乎秒完成——无论你在 AWS CodeBuild、Azure Pipelines 还是 GCP Cloud Build 上跑，只要 runner 共享同一块宿主机磁盘或配置了共享 cache volume，就能复用。
分阶段分层控制 COPY 范围，避免污染缓存
不要 COPY . . 一上来就拷全量代码。优先只拷依赖元文件：
COPY go.mod go.sum ./ RUN go mod download # 此层高度稳定，缓存命中率高 COPY cmd/ internal/ go.* ./ # 只拷必要源码，排除 testdata、docs 等
同时配好 .dockerignore，剔除 node_modules/, __pycache__/, .git/, *.log 等易变文件——它们哪怕只改一个字节，也会让后续所有 RUN 层缓存失效。
CI 配置中配合缓存键做精准复用
以 GitHub Actions 为例，把缓存键与依赖文件哈希绑定：
- uses: actions/cache@v3
with:
path: /home/runner/.cache/go-build
key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
再在 docker build 命令中通过 --build-arg 注入该路径，或直接让 BuildKit 自动发现挂载点。这样，go.sum 不变 → 缓存键不变 → go build 的 object cache 复用 → 编译速度提升 3–5 倍。
不复杂但容易忽略。
