Accueil·Commandes du terminal

npm ci

Paquets et runtimes

Syntaxe

npm ci [--omit=dev]

Supprime node_modules et installe exactement ce que dit package-lock.json ; il ne modifie jamais le fichier de verrouillage et échoue net s'il diverge de package.json, d'où son usage en CI plutôt qu'install.

Options courantes

OptionSignification
--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

Exemples

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

La question est toujours quoi va où : dans ce projet, ou sur la machine entière.

Comment lire

  • Les crochets [ ] marquent une partie facultative.
  • Les points de suspension … signifient qu’on peut en mettre plusieurs.
  • Les options sont sensibles à la casse : sur certaines commandes, -r et -R ne font pas la même chose.

Questions fréquentes

Q. Que fait npm ci ?

Supprime node_modules et installe exactement ce que dit package-lock.json ; il ne modifie jamais le fichier de verrouillage et échoue net s'il diverge de package.json, d'où son usage en CI plutôt qu'install.

Q. Comment l’écrire ?

npm ci [--omit=dev] — les crochets marquent ce qui est facultatif.

Q. Combien d’options valent la peine ?

Il y en a 5 ici ; la liste complète est dans man npm. Cette commande relève de Paquets et runtimes.

Commandes liées

page man: man npm-ci