镜像管理如何优化镜像构建的缓存命中率

核心是编排Dockerfile顺序：先单独COPY依赖文件（如package.json、requirements.txt、go.mod），再安装依赖，最后COPY源码；用.dockerignore排除无关文件；采用多阶段构建隔离环境；固定基础镜像tag并前置ENV，确保缓存稳定复用。

提升镜像构建缓存命中率，核心是让 Docker 能稳定复用已有层——关键不在加资源，而在编排 Dockerfile 的顺序和内容。

把依赖文件单独提前 COPY

这是最直接有效的做法。不要一上来就 COPY 整个代码目录，否则哪怕改一行注释，也会导致后续所有层缓存失效。

1. Node.js 项目：先 COPY package.json 和 package-lock.json，再 RUN npm install；源码最后 COPY
2. Python 项目：先 COPY requirements.txt，再 RUN pip install -r requirements.txt
3. Go 项目：先 COPY go.mod 和 go.sum，再 RUN go mod download

这样只要依赖没变，安装步骤几乎秒级完成，缓存命中率能稳定在 90% 以上。

避免 COPY 过多或不必要文件

COPY 指令会校验所有源文件内容哈希，哪怕只改了一个日志文件，整个层就失效。

1. 用 .dockerignore 排除开发文件（如 node_modules、.git、*.log、test/ 等）
2. 不要 COPY .，改用显式列表或分步 COPY（例如先 COPY config/，再 COPY src/）
3. 对静态资源和业务代码做分离，变动频率低的资源优先 COPY

合理使用多阶段构建

把构建环境和运行环境彻底分开，既能减小最终镜像体积，又能隔离变更影响。

1. 第一阶段用完整工具链编译或打包（如 node:18、golang:1.21）
2. 第二阶段用 alpine 或 distroless 基础镜像，只 COPY 编译产物
3. 构建依赖层完全独立于应用代码，代码频繁更新也不会触发依赖重装

控制基础镜像和环境变量稳定性

缓存链容易被看似无关的改动打断。

1. FROM 使用固定 tag（如 node:18.17-alpine），别用 latest
2. ENV 指令尽量前置，且避免动态值（如 ENV BUILD_TIME=$(date) 会彻底破坏缓存）
3. RUN 指令尽量合并，减少层数，同时避免中间产物残留（如 apt-get install 后记得清理 apt cache）