Ricardo Mello. Engenheiro full-stack sênior, pirado em performance e AI

← artigos npm · javascript · devops 2 min

npm install vs npm ci: qual utilizar?

Atualizado em

Escrito em 2023. Algumas coisas aqui podem ter mudado.

Logo do npm

O comando padrão pra instalar as dependências é o npm install. Se você usa o npm há certo tempo, provavelmente já utiliza esse comando sempre que precisa instalar as dependências de um projeto.

O que nem todo mundo sabe é que desde o npm 5.7 (lá em 2018), existe um comando similar ao npm install chamado npm ci.

Nesse artigo, vamos entender as principais diferenças entre eles e quando utilizar cada um.

npm install

O npm install instala os pacotes do package.json e suas dependências. Se não existe um package-lock.json, ele resolve as versões a partir do ^ ou do ~ e gera o lock. Se o lock já existe e atende ao que tá no package.json, ele respeita o lock e instala exatamente aquelas versões (isso desde o npm 5.4.2). O lock só é reescrito quando precisa: quando você adiciona ou remove um pacote, ou muda uma versão no package.json pra uma faixa que o lock não atende mais.

npm ci

npm ci, ou “clean install” é utilizado para instalar as dependências do zero. Diferente do npm install, esse comando instala as dependências a partir do package-lock.json ou do npm-shrinkwrap.json.

Isso garante que você irá sempre instalar a mesma versão de cada pacote, não importa quantas vezes o comando for executado e nem se houver atualizações disponíveis. Ideal para ambientes de build automatizado ou integração contínua (CI).

Mas tem dois detalhes importantes: ele apaga a pasta node_modules antes de instalar, e se o package.json e o package-lock.json não estiverem em sincronia, ele não tenta resolver nada. Ele dá erro e para. É mais um motivo pra sempre commitar o package-lock.json.

Como ele pula certas etapas como atualizar o package-lock.json e resolver as dependências, esse comando também é muito mais rápido do que o npm install.

Qual usar?

  • No seu ambiente de desenvolvimento, ou sempre que você for adicionar, remover ou atualizar dependências (com npm install <pacote> ou npm update), vale continuar usando o npm install

  • Já no caso de instalar as dependências no seu servidor de integração contínua, ou até mesmo instalar local mas sem atualizar nada, vá de npm ci

Conclusão

Ambos os comandos são similares mas têm aplicações bem distintas. Eu uso o npm install no dia a dia, mas recomendo fortemente a utilização do npm ci no servidor de integração contínua. Além de ter builds mais confiáveis, que quebram quando o lock tá fora de sincronia em vez de instalar outra coisa, ele ainda vai ficar mais rápido.