Início·Comandos de terminal

npm ci

Pacotes e runtimes

Uso

npm ci [--omit=dev]

Apaga node_modules e instala exatamente o que package-lock.json diz; nunca altera o lockfile e falha de imediato se ele divergir do package.json, por isso o CI usa este em vez de install.

Opções comuns

OpçãoSignificado
--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

Exemplos

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

A pergunta é sempre o que vai onde: dentro deste projeto ou na máquina toda.

Como ler

  • Os colchetes [ ] marcam uma parte que você pode omitir.
  • As reticências … indicam que você pode listar vários.
  • As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.

Perguntas

Q. O que npm ci faz?

Apaga node_modules e instala exatamente o que package-lock.json diz; nunca altera o lockfile e falha de imediato se ele divergir do package.json, por isso o CI usa este em vez de install.

Q. Como se digita?

npm ci [--omit=dev] — os colchetes marcam o que você pode omitir.

Q. Quantas opções vale a pena saber?

Aqui estão 5; a lista completa está em man npm. Este comando fica em Pacotes e runtimes.

Comandos relacionados

página man: man npm-ci