node-gyp · npm
El mensaje
gyp ERR! build error
Qué significa
Una dependencia contiene C o C++ que debe compilarse en tu máquina al instalar, y esa compilación falló: node-gyp necesita un compilador y python. Pasa cuando no hay ninguna cadena de compilación instalada, o cuando el paquete es más antiguo que tu node y las cabeceras ya no encajan. Instala las herramientas: xcode-select --install para las herramientas de línea de órdenes en macOS, build-essential y python3 en Debian o Ubuntu, la carga de trabajo de C++ de Visual Studio en Windows. Si una versión más nueva del paquete trae un binario precompilado para tu node, subir el paquete es mucho más rápido que arreglar el entorno de compilación.
El arreglo
No hay un comando de una línea. La explicación dice qué revisar.
- Lo imprime
- node-gyp
- npm
- 20
En npm la causa está en la primera línea code XXXX y no en las seis últimas líneas npm ERR!, y cuando el fallo viene del árbol de dependencias o de una compilación nativa y no de tu código, borrar node_modules y reinstalar resuelve la mitad de los casos.
Cómo leer un mensaje de error
- Lee desde la primera línea. Cuanto más abajo, más son las tripas de la herramienta; la causa suele estar arriba.
- Si hay un archivo y un número de línea, empieza ahí: no el marco superior de la pila, sino la línea más alta que nombre un archivo tuyo.
- Busca el mensaje literal, pero quita antes tus rutas y nombres de variables: eso es lo que impide que la búsqueda coincida.
- La misma condición se redacta distinto según la versión. Si los resultados no cuadran, añade el número de versión.
- Antes de pegar un arreglo, comprueba qué descarta. Algunos no se pueden deshacer.
Preguntas frecuentes
Q. ¿Qué significa «gyp ERR! build error»?
Una dependencia contiene C o C++ que debe compilarse en tu máquina al instalar, y esa compilación falló: node-gyp necesita un compilador y python. Pasa cuando no hay ninguna cadena de compilación instalada, o cuando el paquete es más antiguo que tu node y las cabeceras ya no encajan. Instala las herramientas: xcode-select --install para las herramientas de línea de órdenes en macOS, build-essential y python3 en Debian o Ubuntu, la carga de trabajo de C++ de Visual Studio en Windows. Si una versión más nueva del paquete trae un binario precompilado para tu node, subir el paquete es mucho más rápido que arreglar el entorno de compilación.
Q. ¿Cómo se arregla?
No hay comando de una línea. La explicación de arriba dice qué revisar.
Q. ¿Qué herramienta lo imprime?
node-gyp. Está en npm y el mensaje tiene 4 palabras.