首页/云/Docker 容器速查/Node 镜像中的 npm 安装
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

Node 镜像中的 npm 安装

Node 依赖安装用 npm ci 严格按 lockfile 安装,--omit=dev 控制生产依赖,安装后清理缓存减小镜像。

Docker 容器速查云更新于 2026-10-12
要点npm ci 按 lockfile 且不修改它
生产依赖npm ci --omit=dev
清理npm cache clean --force

示例

示例
COPY package.json package-lock.json ./
RUN npm ci --omit=dev && npm cache clean --force
COPY dist/ ./dist/
npm ci 在 lockfile 缺失或与 package.json 不一致时会失败——这正是它比 npm install 可靠的原因。

易错点

  • 混用 npm/yarn/pnpm 会同时产生多份锁文件,构建时选错包管理器等于锁了个寂寞
  • npm registry 慢时用 .npmrc 配镜像源,但注意私有包与镜像源的认证配置

数据来源与参考

  • npm 官方文档:npm ci(docs.npmjs.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌