必须在同一RUN指令内完成安装与清理，否则缓存仍保留在中间层；Debian/Ubuntu用apt-get clean && rm -rf /var/lib/apt/lists/*，Alpine推荐apk add --no-cache，CentOS/RHEL用yum clean all && rm -rf /var/cache/yum，多阶段构建的builder阶段也需清理。
在构建 Docker 镜像时，清理包管理器缓存（如 apt、yum、apk 的缓存）是减小镜像体积的关键步骤，但必须在 Dockerfile 中规范执行，避免破坏层缓存或引入安全/构建失败风险。
同一 RUN 指令内完成安装与清理
包管理器缓存必须在安装软件的同一 RUN 指令中清理，否则缓存会保留在中间层，无法被后续指令删除。Docker 的分层机制决定了只有当前层的操作才能影响该层内容。
- ✅ 正确写法（以 Debian/Ubuntu 为例）：
RUN apt-get update && apt-get install -y curl nginx && rm -rf /var/lib/apt/lists/* - ❌ 错误写法：
RUN apt-get update && apt-get install -y curl nginxRUN rm -rf /var/lib/apt/lists/*（缓存仍存在于上一层）
区分不同包管理器的清理方式
不同基础镜像使用不同包管理器，清理命令不能通用。需按实际系统选择对应路径和命令：
-
Debian/Ubuntu（apt）：清理
/var/lib/apt/lists/（索引缓存），/var/cache/apt/archives/（下载的 .deb 包）通常已在apt-get install后自动清空；显式清理可用apt-get clean或直接rm -rf /var/lib/apt/lists/* -
Alpine（apk）：运行
apk --no-cache add ...可跳过缓存；若已启用缓存，用apk del .build-deps（配合临时依赖标记）或rm -rf /var/cache/apk/* -
CentOS/RHEL（yum/dnf）：用
yum clean all && rm -rf /var/cache/yum；dnf 推荐dnf clean all && rm -rf /var/cache/dnf
避免在多阶段构建中遗漏清理
即使使用多阶段构建，构建阶段（builder stage）也应清理缓存——否则构建阶段镜像体积膨胀可能拖慢 CI 缓存、本地构建或 registry 上传。
- 构建阶段末尾添加清理指令，例如：
RUN pip install --no-cache-dir -r requirements.txt && rm -rf /root/.cache/pip - 对 Node.js，建议用
--no-cache和npm ci，并清理/root/.npm（若存在） - 注意：某些工具（如 Go 的
go mod download）默认不缓存到磁盘，无需额外清理；但go build若含-mod=vendor则需确认 vendor 目录是否冗余
谨慎处理“清理”与“调试”的冲突
生产构建应严格清理，但开发调试阶段可临时保留缓存以便快速复现问题。可通过构建参数控制：
- 定义构建参数：
ARG KEEP_CACHE=falseRUN if [ "$KEEP_CACHE" = "true" ]; then echo "Skipping cache cleanup"; else apt-get clean && rm -rf /var/lib/apt/lists/*; fi - 构建时传参：
docker build --build-arg KEEP_CACHE=true -t myapp . - 不建议在
Dockerfile中用ENV控制清理行为，因为 ENV 会创建新层且不可变，影响缓存复用
