RUN指令本身不自动清理缓存，必须将安装与清理合并至同一层执行，用&&连接，否则中间缓存会残留于前一层导致镜像虚胖；多阶段构建可彻底规避该问题。
RUN 指令本身不会自动清理缓存，它只负责执行命令并把结果固化为一个新层。真正造成“垃圾”的，不是 RUN 本身，而是安装过程中产生的中间文件（如 apt 缓存、源码目录、压缩包等）——它们被写入了某一层，即使后续用 rm 删除，也只在新层里标记“删了”，旧层里的文件依然物理存在。
所以关键不是“怎么在 RUN 里删”，而是怎么让删除动作和安装动作落在同一层里，避免分层残留。
合并安装与清理到单个 RUN 层
必须把下载、解压、编译、安装、清理全部写在同一行 RUN 中，用 && 连接，确保所有操作都在同一个镜像层内完成：
RUN apt-get update && \
apt-get install -y curl jq && \
rm -rf /var/lib/apt/lists/*
✅ 正确：apt-get install 和 rm -rf /var/lib/apt/lists/* 在同一 RUN 中 → 缓存只存在于该层内部，最终镜像不包含这些临时文件。
❌ 错误：分开写成两个 RUN：
RUN apt-get update && apt-get install -y curl RUN rm -rf /var/lib/apt/lists/* # 这会新增一层，上一层的 lists/ 仍残留
针对不同包管理器的清理写法
| 包管理器 | 典型清理命令（需与安装合并） |
|---|---|
| apt (Debian/Ubuntu) | rm -rf /var/lib/apt/lists/* |
| apk (Alpine) |
apk --no-cache add 或 && apk del .build-deps && rm -rf /var/cache/apk/*
|
| yum/dnf (CentOS/RHEL) | yum clean all && rm -rf /var/cache/yum |
| pip (Python) |
pip install --no-cache-dir 或 && pip cache purge
|
⚠️ 注意：
--no-cache-dir是 pip 的关键参数，否则它会在/root/.cache/pip留下大量缓存，且跨层无法清除。
多阶段构建：彻底绕过 RUN 清理难题
如果安装的是编译型工具（如 gcc、make、node-gyp），又不想把开发环境带进最终镜像，最干净的方式是不用 RUN 清理，而是根本不用保留那层：
# 构建阶段 FROM golang:1.21 AS builder WORKDIR /app COPY . . RUN go build -o myapp . # 运行阶段（纯净环境） FROM alpine:latest RUN apk --no-cache add ca-certificates COPY --from=builder /app/myapp /usr/local/bin/ CMD ["myapp"]
→ 所有构建依赖都留在 builder 阶段，最终镜像完全不包含任何安装缓存或中间产物。
补充：别指望 .dockerignore 或 rm 单独起作用
-
.dockerignore只影响构建上下文上传，不影响 RUN 内部生成的文件； - 单独
RUN rm xxx无法删除前一层的内容，只会新增一层“删除记录”； -
docker system prune等命令清理的是本地构建缓存和悬空层，不能缩小已构建镜像的体积——那是镜像层结构决定的，必须从 Dockerfile 设计源头解决。
本质上，RUN 清理缓存不是靠“删”，而是靠“不写进去”或“写完立刻在同一层擦掉”。
