提升docker镜像构建速度的关键是稳定构建缓存：先copy依赖声明文件并安装，再copy源码；用.dockerignore排除无关文件；固定基础镜像标签并启用buildkit；采用多阶段构建分离编译与运行。
提升 Docker 镜像构建速度，核心不是换机器或加带宽，而是让构建缓存真正“稳住”。只要某一层失效，后面所有层都会重跑——日常改一行代码就触发 npm install 重装几十个包，往往就是缓存没用对。
把依赖安装和代码变更隔离开
关键在于控制 COPY 的粒度和顺序：先只复制声明依赖的文件（如 package.json、requirements.txt、go.mod），紧接着运行安装命令，最后再复制其余源码。
- COPY package.json . && RUN npm ci —— 这层只在 package.json 改动时才重建
- COPY . . 放在最后 —— 即使改了 100 个 JS 文件，前面的依赖安装仍命中缓存
- 避免 COPY . /app 这类粗放写法，它会让整个目录哈希频繁变动
用好 .dockerignore 控制构建上下文
Docker 默认把当前目录整个打包上传。如果混着 node_modules、.git、日志或临时文件，不仅传输慢，还会让 COPY 指令的哈希值无效变动。
- 在项目根目录创建 .dockerignore，明确排除无关内容
- 典型内容包括：node_modules/、.git、logs/、*.log、*.tmp
- 这样 COPY . /app 实际只包含真正需要的源码和配置，缓存稳定性大幅提升
固定基础镜像标签 + 启用 BuildKit
基础镜像不稳定是缓存意外失效的隐形杀手。比如 FROM python:3.11 可能指向不同补丁版本，导致整条缓存链断裂。
- 改用更具体的标签：FROM python:3.11-slim、FROM node:20-alpine
- 启用 BuildKit：设置环境变量 DOCKER_BUILDKIT=1
- 配合 cache mount 复用本地缓存，例如：
RUN --mount=type=cache,target=/root/.npm npm ci --no-audit
多阶段构建天然适配缓存复用
它把构建和运行拆成独立阶段，彼此缓存互不干扰。即使源码天天变，依赖下载层也不会受影响——只要 go.mod 没动，go mod download 就永远秒过。
- builder 阶段专注下载、编译，可长期缓存
- runner 阶段只 COPY 编译结果，用最小基础镜像（如 alpine）
- CI 场景下，还能结合 --cache-from 拉取远程缓存，跨节点复用
