Início·Mensagens de erro

npm · npm

A mensagem

npm ERR! The `npm ci` command can only install with an existing package-lock.json or npm-shrinkwrap.json

O que significa

O npm ci não roda de jeito nenhum sem lockfile, porque não tem nada dizendo quais versões instalar. Acontece quando o package-lock.json está no .gitignore, nunca foi commitado, ou quando o diretório em que você está não é a raiz do projeto. O npm install --package-lock-only escreve o lockfile sem instalar nada, e commitá-lo faz a CI funcionar. Nunca coloque package-lock.json no .gitignore: a garantia de que a CI compila a mesma coisa duas vezes se apoia nesse único arquivo.

A correção

npm install --package-lock-only
Impresso por
npm
npm
20

No npm a causa está na primeira linha code XXXX e não nas seis últimas linhas npm ERR!, e quando a falha vem da árvore de dependências ou de uma compilação nativa em vez do seu código, apagar node_modules e instalar de novo resolve metade dos casos.

Como ler uma mensagem de erro

  • Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
  • Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
  • Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
  • A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
  • Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.

Perguntas frequentes

Q. O que significa “npm ERR! The `npm ci` command can only install with an existing package-lock.json or npm-shrinkwrap.json”?

O npm ci não roda de jeito nenhum sem lockfile, porque não tem nada dizendo quais versões instalar. Acontece quando o package-lock.json está no .gitignore, nunca foi commitado, ou quando o diretório em que você está não é a raiz do projeto. O npm install --package-lock-only escreve o lockfile sem instalar nada, e commitá-lo faz a CI funcionar. Nunca coloque package-lock.json no .gitignore: a garantia de que a CI compila a mesma coisa duas vezes se apoia nesse único arquivo.

Q. Como corrigir?

npm install --package-lock-only — antes de rodar, veja acima o que este comando descarta.

Q. Qual ferramenta imprime isso?

npm. Fica em npm e a mensagem tem 15 palavras.

Erros próximos