Docker 镜像层和构建缓存如何工作？

Question

Accepted Answer

Docker 镜像以**层**的方式构建——每个 Dockerfile 指令创建一个层，Docker **缓存**这些层以加速重新构建。理解层和缓存是编写高效 Dockerfile 的关键，这样的 Dockerfile 构建速度快且生成的镜像较小。

## 层——每个指令添加一个层

```text
Each Dockerfile instruction (FROM, RUN, COPY, etc.) creates a read-only LAYER:
  → layers stack to form the image; layers are CACHED and SHARED between images
  → if a layer is unchanged, Docker REUSES the cached layer (skips rebuilding it)
→ Layer caching makes rebuilds fast — only changed layers (and those AFTER) rebuild.
```

## 缓存规则（顺序很重要）

```text
Docker caches layers IN ORDER. When an instruction's input changes, that layer AND
ALL layers AFTER IT are rebuilt (cache invalidated from that point down).
→ Put STABLE things EARLY and FREQUENTLY-CHANGING things LATE in the Dockerfile.
```

## 经典优化：在代码之前安装依赖

```dockerfile
# ✅ GOOD — copy dependency manifest first, install, THEN copy code
COPY package*.json ./
RUN npm install          # this layer is cached UNLESS package.json changes
COPY . .                 # code changes here don't invalidate the npm install layer

# ❌ BAD — copy everything first
COPY . .                 # ANY code change invalidates...
RUN npm install          # ...so npm install RE-RUNS on every code change (slow!)
```

通过在复制其余代码之前复制依赖文件并安装依赖，（缓慢的）依赖安装层在代码更改时保持缓存——这是一个非常重要的优化，使重新构建速度很快。

## 减小镜像大小

```text
✓ Combine related RUN commands (fewer layers) and clean up in the SAME layer
  RUN apt-get update && apt-get install -y x && rm -rf /var/lib/apt/lists/*
✓ Use small base images (alpine, slim, distroless)
✓ Use .dockerignore to exclude unneeded files from the build context
✓ Use multi-stage builds (build artifacts in one stage, copy only what's needed)
```

## 为什么这很重要

理解 Docker 层和构建缓存对于**编写高效的 Dockerfile** 非常重要，这样的 Dockerfile 构建快速且生成较小的镜像，因此这是实际应用价值高的知识，显著影响开发者生产力和部署。

基础概念——每个 Dockerfile 指令创建一个缓存的、可重用的**层**，Docker **重用未更改的缓存层**，同时重新构建已更改的层及其之后的所有层——这解释了如何加快构建速度。

**关键缓存规则**（缓存从第一个更改的指令向下失效，因此顺序很重要：稳定的内容放在前面，经常变化的内容放在后面）驱动了**最重要的单一优化**：在复制应用代码**之前**复制依赖文件并安装依赖，这样缓慢的依赖安装层在频繁的代码更改中保持缓存（而不是在每次代码更改时重新运行 `npm install`/`pip install`——这是快速重建和痛苦缓慢重建之间的差异）。

仅仅理解这个模式就能显著改进构建时间，这是开发者体验的一个持续关注点。

了解**减小镜像大小**的技术——在同一层中合并 RUN 命令和清理、使用较小的基础镜像（alpine、slim、distroless）、使用 `.dockerignore` 排除不必要的文件、多阶段构建——能生成更小、更快部署的镜像（减少存储空间、传输时间和攻击面）。

由于 Docker 构建频繁进行（在开发和 CI/CD 中），缓慢的构建或臃肿的镜像会损害生产力和部署，而理解层和缓存正是能够编写构建快速、保持精简的 Dockerfile 的关键，因此理解 Docker 层和构建缓存——层模型、依赖顺序的缓存规则、依赖在代码之前的优化、以及大小减小技术——是高效使用 Docker 的有价值、经常应用的知识，这是一项关键技能，区分了那些编写快速、精简 Dockerfile 的人和那些遭受缓慢构建和臃肿镜像困扰的人。