关键在于把变动少的操作放前面、变动多的放后面；docker缓存顺序敏感，某层变更则其后所有层重建。应先copy依赖文件（如package.json）、再run安装、最后copy源码，并用.dockerignore过滤无关文件，结合多阶段构建与固定基础镜像标签提升缓存复用率。

关键在于把变动少的操作放前面，变动多的放后面。docker 缓存是顺序敏感的——只要某一层变了，它之后所有层都会重建。所以指令顺序不是写法习惯问题，而是缓存能否复用的决定性因素。

先复制依赖文件，再安装依赖

比如 Node.js 项目中，package.json 和 package-lock.json 变更频率远低于源码。把它们单独 COPY 到镜像中，再 RUN npm install，就能让依赖安装这一步稳定命中缓存。

• COPY package.json package-lock.json ./
• RUN npm install --production
• COPY . .（最后才复制全部源码）

这样改一个 JS 文件，不会触发 npm install 重跑。

避免 COPY . . 过早出现

如果在 Dockerfile 开头就写 COPY . .，哪怕只改了一个日志文件或 README，整个构建上下文哈希值就变了，后续所有层缓存全失效。

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

• 把 COPY . . 移到依赖安装之后
• 配合 .dockerignore 排除 node_modules、.git、logs 等无关内容
• 确保只有真正参与构建的文件进入上下文

多阶段构建中分层隔离依赖

编译类项目（如 Go、Rust、Java）适合用多阶段构建，把下载依赖和编译过程拆到 builder 阶段，运行时只 COPY 二进制文件。

• builder 阶段：COPY go.mod go.sum → RUN go mod download → COPY . . → RUN go build
• final 阶段：FROM alpine → COPY --from=builder /app/server .

go.mod 不变时，builder 阶段前几步完全复用缓存，哪怕源码天天改也不影响。

固定基础镜像标签，减少隐性变更

用 FROM ubuntu:20.04 比 FROM ubuntu:latest 更可靠。后者可能指向不同镜像，导致第一层就缓存失效。

• 优先使用带明确版本号或 digest 的基础镜像
• 例如：FROM golang:1.21.6-alpine 或 FROM python:3.9-slim@sha256:abc...