如何用Dockerfile RUN --mount缓存CMake构建输出实现快速迭代？

核心思路 #

要实现修改源码后仅增量编译，关键是拆分Docker构建层，利用BuildKit的缓存挂载保留构建中间状态，同时避免源码修改触发CMake重新执行。具体要做到：

• 把环境依赖、CMake配置这些不变的步骤放在前面，利用Docker层缓存
• 用--mount=type=cache持久化build目录，保留make/ninja的编译中间文件
• 先复制CMake相关配置文件再执行CMake，避免源码修改导致CMake层失效

修改后的Dockerfile #

# 启用BuildKit（必须，否则--mount语法不生效）
# syntax=docker/dockerfile:1.4

FROM ubuntu
WORKDIR /app

# 1. 安装依赖：这层仅在依赖包变更时重新执行
RUN apt-get update && \
    apt-get install -y build-essential cmake ninja-build ETC_ETC_ETC && \
    rm -rf /var/lib/apt/lists/*

# 2. 先复制CMake配置文件：仅当CMake相关文件变更时才会重新执行CMake
COPY CMakeLists.txt ./
# 如果项目有额外的cmake模块/配置目录，也需要单独复制
# COPY cmake/ ./cmake/

# 3. 初始化构建目录并执行CMake：利用缓存挂载保留CMake生成的构建文件
RUN --mount=type=cache,target=/app/build,sharing=locked \
    mkdir -p build && cd build && cmake .. -G Ninja

# 4. 复制全部源码：修改源码只会触发这层及之后的步骤
COPY . ./

# 5. 增量编译并安装：复用build缓存中的中间文件，仅编译修改的源码
RUN --mount=type=cache,target=/app/build,sharing=locked \
    cd build && ninja -j4 && ninja install

# 运行程序
CMD ["/app/build/bin/exec"]

使用流程 #

1. 启用BuildKit：Linux/macOS执行export DOCKER_BUILDKIT=1，Docker Desktop用户可在设置中开启BuildKit选项
2. 首次构建：docker build -t my-app .（耗时约10分钟，完成后依赖、CMake状态会被缓存）
3. 修改本地源码后，再次执行docker build -t my-app .：此时仅重新复制源码并执行增量编译，耗时3-4秒

提取make install生成的目录 #

有两种实用方式：

方式1：运行临时容器复制 #

# 将容器内的安装目录复制到本地临时目录
docker run --rm my-app cp -r /path/to/install/dir /tmp/install-output
# 或挂载本地目录直接导出
docker run --rm -v $(pwd)/install-output:/output my-app cp -r /path/to/install/dir/* /output

方式2：构建时直接导出（BuildKit支持） #

使用docker build的--output参数，直接将安装目录导出到本地：

docker build --output type=local,dest=./install-output -t my-app .

关键说明 #

• VOLUME不适用：VOLUME是运行时挂载机制，无法在构建阶段保留build目录的中间状态，不符合构建缓存需求
• 先复制CMakeLists.txt的原因：如果先复制全部源码，任何源码修改都会导致CMake层的缓存失效，必须重新执行CMake；单独复制CMake配置文件后，仅当配置变更时才会触发CMake重新运行
• sharing=locked：确保同一时间只有一个构建进程使用缓存目录，避免并发构建导致的文件冲突

内容的提问来源于stack exchange，提问作者Chris Lam