node-gyp · npm
A mensagem
gyp ERR! build error
O que significa
Uma dependência contém C ou C++ que precisa ser compilado na sua máquina na hora da instalação, e essa compilação falhou: o node-gyp precisa de um compilador e de python. Acontece quando não há nenhuma cadeia de compilação instalada, ou quando o pacote é mais antigo que o seu node e os headers já não combinam. Instale as ferramentas: xcode-select --install para as ferramentas de linha de comando no macOS, build-essential e python3 no Debian ou Ubuntu, a carga de trabalho C++ do Visual Studio no Windows. Se uma versão mais nova do pacote traz um binário pré-compilado para o seu node, subir o pacote é bem mais rápido que arrumar o ambiente de compilação.
A correção
Não há um comando de uma linha. A explicação diz o que verificar.
- Impresso por
- node-gyp
- 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 “gyp ERR! build error”?
Uma dependência contém C ou C++ que precisa ser compilado na sua máquina na hora da instalação, e essa compilação falhou: o node-gyp precisa de um compilador e de python. Acontece quando não há nenhuma cadeia de compilação instalada, ou quando o pacote é mais antigo que o seu node e os headers já não combinam. Instale as ferramentas: xcode-select --install para as ferramentas de linha de comando no macOS, build-essential e python3 no Debian ou Ubuntu, a carga de trabalho C++ do Visual Studio no Windows. Se uma versão mais nova do pacote traz um binário pré-compilado para o seu node, subir o pacote é bem mais rápido que arrumar o ambiente de compilação.
Q. Como corrigir?
Não há comando de uma linha. A explicação acima diz o que verificar.
Q. Qual ferramenta imprime isso?
node-gyp. Fica em npm e a mensagem tem 4 palavras.