docker构建提速核心在于分层缓存管理：指令顺序决定缓存上限，应先copy依赖文件（如package.json）再run安装，最后copy源码；配合.dockerignore、多阶段构建及--cache-from可显著提升命中率。
要让 docker 构建又快又稳，核心不在堆硬件，而在管好缓存——它不是开关，而是一套可预测、可干预的层匹配机制。关键在于理解“哪一层会失效”“为什么没命中”，再针对性调整。
分层顺序决定缓存命中的上限
Docker 每执行一条指令（FROM、COPY、RUN 等）就生成一个只读层，缓存复用从上到下逐层比对。只要某一层变了，它之后所有层全部重建。
- 把变动少的内容放前面：比如先 COPY package.json 或 go.mod，再 RUN npm install 或 go mod download
- 把变动多的内容放后面：比如最后 COPY ./src 或 .，避免一次代码修改导致依赖重装
- 避免在中间插入 ENV 或 RUN 改变环境状态——哪怕只是加个空格，也会让后续层全部失效
构建上下文是缓存稳定的隐形推手
docker build 的 “.” 不只是路径，而是整个打包上传给守护进程的文件集合。无关文件混入，会让 COPY 指令实际读取的文件哈希值意外变化，从而击穿缓存。
- 务必配置 .dockerignore：排除 node_modules、.git、*.log、build/ 等非必要目录
- COPY 指令尽量精确：用 COPY package.json . 而非 COPY . .，减少因临时文件触发重建
- 不要在构建上下文中放动态生成文件（如 timestamp.txt），它们会让缓存永远不命中
多阶段构建让缓存真正“分段复用”
单阶段 Dockerfile 中，哪怕只改一行业务代码，RUN pip install 这类耗时步骤也可能被连带重建。多阶段通过 AS 命名隔离构建逻辑，让依赖安装、编译、打包各阶段独立缓存。
- 第一阶段只 COPY 依赖清单（go.mod、package-lock.json），RUN 下载或安装
- 第二阶段 COPY --from=builder 把产物复制进来，不带任何构建工具链
- 不同阶段可用不同基础镜像（如 builder 用 golang:1.21，runner 用 alpine:latest）
CI/CD 中让缓存跨构建持续生效
本地开发能靠历史构建自动缓存，但 CI 流水线每次都是新环境。必须主动注入缓存源，否则每轮都从零开始。
- 使用 --cache-from 指定上一次成功构建的镜像：docker build --cache-from=myapp:latest -t myapp:dev .
- 搭配 BuildKit 启用 inline 缓存：DOCKER_BUILDKIT=1 docker build --push --cache-to type=inline ...
- 清理无用缓存防磁盘爆满：docker builder prune -f（定期执行，尤其在 CI Agent 上）
