Instalar npm en Windows no es precisamente complicado, pero es una de esas cosas en las que te das cuenta de que la clave está en los detalles. Quizás hayas intentado instalar Node.js y npm, pero la línea de comandos no lo reconoce, o te aparecen errores extraños como «comando no encontrado».O quizás quieras asegurarte de que todo funciona correctamente antes de embarcarte en proyectos importantes. Sea cual sea el motivo, solucionar estos problemas puede ser frustrante, sobre todo cuando Windows a veces se niega a funcionar correctamente con las variables de entorno. Esta guía te ayudará a solucionar estos problemas comunes y a conseguir que npm funcione correctamente en Windows, para que puedas dedicar menos tiempo a perder el tiempo y más tiempo a programar.
Cómo solucionar el problema de npm no reconocido en Windows
Método 1: Asegúrese de que Node.js y npm estén correctamente instalados y en PATH
Este es el problema más común: npm está instalado, pero Windows no lo encuentra porque la ruta del sistema no incluye la carpeta donde se encuentra. Probablemente hayas instalado Node.js desde el sitio oficial, pero a veces, durante la instalación, la casilla para agregar Node a la ruta se omite o Windows simplemente olvida actualizar las variables de entorno inmediatamente. En este caso, al abrir un nuevo símbolo del sistema, los comandos de npm no se reconocen. A continuación, te indicamos cómo hacerlo:
- Presione la tecla Windows, escriba Variables de entorno y seleccione Editar las variables de entorno del sistema.
- En la ventana Propiedades del sistema, haga clic en Variables de entorno.
- En Variables del sistema, desplácese hacia abajo para encontrar Ruta y luego haga clic en Editar.
- Comprueba si existe una ruta a tu carpeta Node.js, normalmente algo como
C:\Program Files\nodejs\. Si no la encuentras, haz clic en «Nuevo» y añade esa ruta. - Haga clic en Aceptar completamente y reinicie el Símbolo del sistema. Luego, escriba
npm -v. Si muestra un número de versión, ¡todo está bien!
Esta solución es útil porque Windows necesita saber dónde buscar npm al llamarlo. Si no está en PATH, Windows ignora el comando porque desconoce la ubicación de npm.
Método 2: reinstalar Node.js, asegurándose de agregarlo a PATH
Si lo anterior sigue sin reconocer npm, podría ser más fácil reinstalar Node.js. A veces, una instalación no agrega Node.js automáticamente a PATH, especialmente si se omite un paso durante la configuración. Para solucionar esto:
- Descargue la última versión LTS desde la página oficial de descarga de Node.js.
- Ejecuta el instalador y presta atención a los pasos de configuración. Hay una opción como «Añadir a PATH» o «Establecer variables de entorno automáticamente».Asegúrate de que esté marcada. Claro que Windows a veces lo hace un poco sutil, así que compruébalo.
- Finaliza la instalación y abre un nuevo símbolo del sistema. Ejecútalo
npm -vde nuevo.¡Ojalá funcione!
A menudo esto resuelve el problema porque una instalación nueva con las opciones adecuadas configura todo limpiamente.
Método 3: comprobar si npm está realmente instalado
En muchos casos, solo es cuestión de verificar si npm está presente, o quizás algo falló durante la instalación. Dirígete a C:\Archivos de programa\nodejs\ o donde hayas instalado Node. Busca npm.cmd o npm dentro de esa carpeta. Si no está, npm no se instaló correctamente y podrías tener que reinstalar Node.js desde cero.
Consejo: Ejecútalo node -ven el símbolo del sistema para confirmar que Node.js se está ejecutando. Si muestra una versión, pero npm -vno la muestra, el problema definitivamente está en npm, no en Node.js.
Método 4: Usar nvm para Windows para administrar múltiples versiones de nodos
Quizás hayas instalado Node.js varias veces o hayas incompatibilidad entre otras versiones. Esto puede provocar que npm deje de funcionar o sea inaccesible. Nvm para Windows (un gestor de versiones de Node) ayuda a mantenerlos limpios, por lo que instalar y cambiar entre diferentes versiones de Node es pan comido. Es muy útil si estás gestionando varios proyectos o necesitas versiones específicas de Node/npm:
- Descargue nvm para Windows desde su repositorio de GitHub.
- Instálalo y luego usa comandos como y.
nvm installnvm use - Una vez que una versión esté activa, verifique si npm funciona ejecutando
npm -v.
No es totalmente necesario para todos, pero a veces, simplemente cambiar a una versión que funciona correctamente ayuda a solucionar problemas de rutas o permisos. Además, mantiene todo ordenado.
Método 5: Borrar la caché de npm y reinstalar los paquetes de npm
Ah, y a veces, no es la RUTA, sino una caché de npm corrupta la que está causando problemas. Para una rápida comprobación de seguridad:
- Abra el símbolo del sistema como administrador.
- Escribe
npm cache clean --forcepara borrar la caché. Esto es útil si npm genera errores extraños o se comporta de forma extraña. - Luego, intenta ejecutarlo
npm -vde nuevo. Si sigue sin funcionar, considera reinstalar npm manualmente (aunque normalmente, reinstalar Node.js soluciona este problema).
En algunas configuraciones, una caché dañada o una carpeta npm desordenada pueden causar errores de reconocimiento. Borrarla suele solucionar el comportamiento extraño.
A veces, Windows simplemente quiere ser complicado, y requiere un poco de investigación para alinearlo todo. No sé por qué funciona, pero después de experimentar lo suficiente, npm finalmente cobra vida, y eso es lo que importa.