Docker Compose 构建速度慢如何利用构建缓存优化加速

最推荐的做法是调整 Dockerfile 指令顺序并启用 BuildKit 构建后端，这能最大限度复用本地层缓存，适用于大多数本地开发和常规 CI 场景。

先说结论：构建慢通常是因为缓存失效，优化重点在于减少无效层变更和开启高效构建模式。

先定位：确认是否每次构建都拉取基础镜像或重新执行耗时指令。
先做：调整 Dockerfile COPY 顺序，设置 DOCKER_BUILDKIT=1 环境变量。
再验证：观察第二次构建时是否命中缓存且耗时明显缩短。

命令速用版

如果你希望立即尝试优化，可以在终端执行以下命令启用构建缓存加速：

export DOCKER_BUILDKIT=1
docker-compose build `--progress`=plain

同时确保项目根目录存在 .dockerignore 文件，排除不必要的上传文件。

为什么会这样

Docker 构建镜像是分层的，每一层指令（如 RUN、COPY）都会生成一个缓存层。如果某一层指令及其上下文没有变化，Docker 会直接使用之前的缓存，跳过执行。构建慢往往是因为 Docker 认为上下文变了，导致后续所有层都必须重新构建。启用 BuildKit 后，构建后端会采用更高效的缓存策略和并行处理能力，而合理的指令顺序能防止因代码频繁变动而拖累依赖安装等耗时步骤。

分步处理

1. 调整 Dockerfile 指令顺序

将变化频率低的指令放在前面，变化频率高的放在后面。通常建议先复制依赖配置文件，安装依赖，最后复制源代码。

COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .

2. 启用 BuildKit 构建后端

在执行构建命令前，导出环境变量。这在新版 Docker 中通常默认开启，但显式设置更稳妥。

export DOCKER_BUILDKIT=1

3. 配置 .dockerignore

在项目根目录创建或编辑 .dockerignore，排除构建不需要上传到守护进程的文件，减少上下文传输时间。

.git
__pycache__
*.log
.env

4. 避免滥用 `--no-cache`

除非确实需要强制重新构建，否则不要在日常开发中使用 docker-compose build `--no-cache`，这会禁用所有缓存。

怎么验证是否生效

执行两次构建命令，观察第二次输出的日志。如果优化生效，你会看到类似 CACHED 的标记，或者某些步骤直接跳过执行，且总耗时少于第一次。在使用 `--progress`=plain 参数时，缓存命中的层会明确显示为缓存状态。

常见坑

1. COPY . . 放得太早：如果在安装依赖前就复制了全部代码，任何代码修改都会导致依赖安装层缓存失效。

2. 基础镜像标签不固定：如果 Dockerfile 中使用 FROM python:latest，每次拉取的最新镜像可能不同，导致后续层缓存失效。建议固定具体版本号。

3. 忽略环境变量影响：某些构建参数或 ARG 的变化也会使缓存失效，注意检查构建命令中的构建参数是否一致。

参考来源

Docker Official Documentation, "Best practices for writing Dockerfiles", https://docs.docker.com/build/building/best-practices/#leverage-build-cache
Docker Official Documentation, "Compose CLI reference", https://docs.docker.com/compose/reference/build/
Docker Official Documentation, "BuildKit", https://docs.docker.com/build/buildkit/