首页/云/Docker 容器速查/RUN --mount=type=cache 构建缓存挂载
镜像与构建107 条

RUN --mount=type=cache 构建缓存挂载

把包管理器的下载缓存挂载进构建步骤:缓存不写入镜像层,多次构建之间可复用,显著减少重复下载。

Docker 容器速查云更新于 2026-10-12
用途加速依赖安装(apt/pip/npm/...)
语法RUN --mount=type=cache,target=/root/.cache/pip ...
依赖BuildKit(dockerfile 1.x)

示例

示例
RUN --mount=type=cache,target=/root/.cache/pip \
    pip install -r requirements.txt

RUN --mount=type=cache,target=/root/.npm \
    npm ci --prefer-offline
缓存保存在构建器内部;CI 里配合 buildx 的 cache-to/cache-from 或复用同一构建器实例。

易错点

  • target 要指向工具真实使用的缓存目录,写错时缓存命中为零、构建依旧全量下载
  • 缓存内容不参与镜像校验:依赖版本变更后如果包管理器未强校验,可能留下旧缓存产物

数据来源与参考

  • Docker 官方文档:Build cache mounts(docs.docker.com/build/cache/optimize)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌