npm ci

パッケージと実行環境

書き方

npm ci [--omit=dev]

node_modulesを消し、package-lock.jsonに書かれた通りだけを入れます。ロックファイルを書き換えず、package.jsonと食い違えばその場で失敗するので、CIではinstallの代わりにこれを使います。

よく使うオプション

オプション意味
--omit=devproduction dependencies only
--ignore-scriptsskip lifecycle scripts, common in CI
--prefer-offlineuse the cache whenever it can
--no-auditskip the vulnerability check for speed
--cache <dir>point at a cache directory the CI runner keeps

npm ci

deletes node_modules and installs exactly what the lockfile says

npm ci --omit=dev

a production install for a container image

npm ci --ignore-scripts

installs without running third-party install hooks

何をどこに入れるかが問題です。このプロジェクトの中か、マシン全体かを先に決めてください。

読み方

  • 角括弧 [ ] は省いてよい部分です。
  • 三点 … は複数並べられるという意味です。
  • オプションは大文字小文字を区別します — -r と -R が別物のコマンドもあります。

よくある質問

Q. npm ci は何をしますか。

node_modulesを消し、package-lock.jsonに書かれた通りだけを入れます。ロックファイルを書き換えず、package.jsonと食い違えばその場で失敗するので、CIではinstallの代わりにこれを使います。

Q. どう打ちますか。

npm ci [--omit=dev] — 角括弧は省いてよい部分です。

Q. よく使うオプションはいくつですか。

ここにまとめたのは5個です。全部は man npm にあります。このコマンドはパッケージと実行環境の仲間です。

関連するコマンド

man ページ: man npm-ci