首頁·終端機命令

npm ci

套件與執行環境

用法

npm ci [--omit=dev]

先刪掉 node_modules,再嚴格按 package-lock.json 安裝;它絕不改動 lockfile,一旦和 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 安裝;它絕不改動 lockfile,一旦和 package.json 不一致就直接失敗,所以 CI 用它而不是 install。

Q. 怎麼寫?

npm ci [--omit=dev] —— 方括號表示可以省略的部分。

Q. 值得記的選項有幾個?

這裡列了 5 個,完整列表在 man npm。這條命令屬於套件與執行環境。

相關命令

man 手冊: man npm-ci