如何利用 Dockerfile 优化镜像构建速度

优化 Dockerfile 构建速度的核心是提升缓存复用率、启用 BuildKit 并行构建、选用轻量基础镜像、合理使用 .dockerignore 减小上下文。

优化 Dockerfile 构建速度，核心在于让每一层尽可能复用缓存、减少冗余操作，并借助现代构建机制提升并行与效率。不靠堆硬件，而靠写法和策略。

合理安排指令顺序，最大化缓存命中

Docker 按顺序执行每条指令，一旦某层缓存失效，其后所有层都会重新构建。把变动少的内容放在前面，是提速最直接的手段。

1. 先 COPY 依赖清单（如 package.json、requirements.txt），再 RUN 安装依赖；源码最后 COPY
2. 避免 COPY . . 放在依赖安装之前——哪怕只改一行代码，也会导致 npm install 或 pip install 重跑
3. 使用 npm ci 替代 npm install，它基于 package-lock.json 精确还原，更快更稳定

启用 BuildKit，解锁并行与智能缓存

BuildKit 是 Docker 最新推荐的新一代构建后端，默认在较新版本中可用，能显著缩短构建时间。

1. 启用方式：构建前设置环境变量 DOCKER_BUILDKIT=1，或使用 docker buildx build
2. 支持自动跳过未变更的步骤、并行执行独立 RUN 指令、更精准的缓存键计算
3. 配合 # syntax=docker/dockerfile:1 可启用高级特性，如 RUN --mount=type=cache 加速包管理器缓存

精简基础镜像，降低传输与解压开销

基础镜像越小，拉取越快、解压越快、构建上下文加载也越轻量。这不是“省体积”而是“省时间”。

1. 优先选用 -slim 或 -alpine 变体（如 python:3.10-slim、node:18-alpine）
2. 避免用完整发行版（如 ubuntu:22.04），它们自带大量非运行必需的工具和文档
3. 对静态二进制语言（Go/Rust），可考虑 scratch 作为最终阶段基础镜像，彻底零依赖

用好 .dockerignore，减小构建上下文

构建时，Docker 会把当前目录（或指定路径）整个打包发送给守护进程。大文件、临时目录、开发配置混在里面，会拖慢整个流程。

1. 在项目根目录创建 .dockerignore，明确排除 node_modules/、.git/、__pycache__/、*.log 等
2. 不要依赖 ADD 自动解压来“绕过”上下文限制——它反而增加构建步骤和不确定性
3. 检查上下文大小：运行 docker build -t test . --progress=plain 2>&1 | grep "Sending build context" 可看到实际传输量