核心是让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、测试工具）只在构建阶段需要，运行时完全不需要。多阶段构建能彻底隔离它们：

wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support

基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。

下载

• 第一阶段用完整镜像（如 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 清理残留