核心是让Docker层缓存真正起作用并避免构建开销进入最终镜像：Node.js项目应先COPY package*.json再RUN npm ci --only=production，最后COPY源码；采用多阶段构建分离开发与运行环境，并启用BuildKit提升缓存效率。
核心是让 Docker 的层缓存真正起作用，同时避免把构建时的开销带进最终镜像。Node.js 本身不编译，但 npm install 和文件拷贝顺序直接影响构建快慢——多数慢构建不是机器性能问题，而是 Dockerfile 写法不合理。
利用分层缓存，把稳定操作放前面
Docker 按指令逐层构建，只要某一层没变，后续所有缓存层都可复用。Node.js 项目中，package.json 和 package-lock.json 变更频率远低于源码，所以必须优先拷贝并安装依赖：
- ✅ 正确顺序：先
COPY package*.json .→ 再RUN npm ci --only=production→ 最后COPY . . - ❌ 错误顺序：先
COPY . .再RUN npm install—— 每次改一行代码，整个node_modules都要重装 -
npm ci比npm install更适合 CI/CD，它严格按 lock 文件还原，不写新 lock，也更快更确定
用多阶段构建，剥离构建环境
开发依赖（如 TypeScript、Webpack、测试工具）只在构建阶段需要，运行时完全不需要。多阶段构建能彻底隔离它们：
- 第一阶段用完整镜像（如
node:18）做构建：RUN npm ci && npm run build - 第二阶段用轻量镜像（如
node:18-alpine）仅复制dist/、node_modules和必要文件 - 这样既避免了 devDependencies 打包进最终镜像，又让构建阶段能用完整工具链，互不干扰
启用 BuildKit，提升构建效率和透明度
Docker BuildKit 是现代构建引擎，默认已在新版 Docker 启用，但显式声明可解锁更多优化能力：
- 在 Dockerfile 第一行加：
# syntax=docker/dockerfile:1 - 支持并行化构建步骤、更好的缓存命中率、更清晰的构建日志
- 配合
--cache-from和--cache-to，可在 CI 中跨流水线复用缓存，大幅缩短构建时间
精简依赖，减少安装耗时和体积
安装环节往往是构建最慢的部分，而很多依赖其实不该出现在生产镜像里：
- 确认
devDependencies确实只用于开发：比如eslint、jest、typescript不应进入运行时 - 用
npm ci --only=production或yarn install --production，跳过 dev deps 安装 - 检查是否有重复或废弃包：
npm ls --depth=0查顶层依赖，npm prune --production清理残留
