npm ci
套件與執行環境
用法
npm ci [--omit=dev]先刪掉 node_modules,再嚴格按 package-lock.json 安裝;它絕不改動 lockfile,一旦和 package.json 不一致就直接失敗,所以 CI 用它而不是 install。
常用選項
| 選項 | 含義 |
|---|---|
| --omit=dev | production dependencies only |
| --ignore-scripts | skip lifecycle scripts, common in CI |
| --prefer-offline | use the cache whenever it can |
| --no-audit | skip the vulnerability check for speed |
| --cache <dir> | point at a cache directory the CI runner keeps |
範例
npm cideletes node_modules and installs exactly what the lockfile says
npm ci --omit=deva production install for a container image
npm ci --ignore-scriptsinstalls 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