node.js镜像体积优化的核心是精准裁剪，只保留运行时必需的代码、生产依赖和node.js运行时。通过选用alpine或distroless基础镜像、多阶段构建分离构建与运行环境、npm ci --only=production精简依赖、清除缓存日志等冗余文件，可将1.2gb镜像压缩至95mb以内。
node.js 镜像体积优化的核心，是只保留运行时真正需要的东西——应用代码、生产依赖、node.js 运行时，其余一概剔除。一个 1.2gb 的镜像缩到 95mb 甚至更小，不是靠压缩，而是靠“精准裁剪”。
选对基础镜像：起点决定上限
基础镜像占最终体积大头，必须从源头压降：
-
优先用 Alpine 版本：如
node:20-alpine（约 5–15MB），比node:20（300MB+）小 90% 以上；适合大多数纯 JS 应用 -
安全敏感或极致精简场景用 distroless：如
gcr.io/distroless/nodejs:20（约 20–30MB），无 shell、无包管理器，攻击面极小 - 避免 ubuntu/debian:latest：自带大量系统工具和文档，与 Node.js 运行无关，徒增体积和漏洞风险
多阶段构建：拆掉“施工队”，只留“精装房”
这是最有效、最通用的瘦身手段，把构建环境和运行环境彻底隔离：
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 第一阶段（builder）：用完整镜像（如
node:20）安装所有依赖、执行npm run build、生成dist/ - 第二阶段（runner）：用 Alpine 或 distroless 镜像，仅
COPY --from=builder复制dist/和node_modules（生产依赖） - 关键细节：
RUN npm ci --only=production或--omit=dev必须在 builder 阶段执行，确保node_modules不含 webpack、tsc 等开发工具
依赖精简：删掉一半 node_modules 很常见
很多项目 devDependencies 数量远超 dependencies，它们在运行时完全无用：
- 用
npm ci --only=production安装，比npm install少载 40–60% 的包 - 检查
package.json，移除长期未用的依赖（比如旧版babel插件、已弃用的工具库） - 对前端项目，可额外
COPY dist/而非整个源码目录，避免把src/、tests/、.git打进镜像
清理冗余文件：缓存、日志、调试工具一个不留
每一层 RUN 指令后都可能留下临时数据，必须显式清除：
- Alpine 系统：加
RUN rm -rf /var/cache/apk/* - npm 缓存：加
RUN npm cache clean --force - 如果用了 TypeScript，构建后可删
src/和.ts文件（前提是已编译为 JS 并验证通过） - 避免在最终镜像中保留
package-lock.json、npm-debug.log、.dockerignore等非运行必需文件
