Respuesta corta: NVM para Windows es un proyecto distinto del nvm de Mac y Linux. Descarga nvm-setup.zip desde la página de versiones de nvm-windows, ejecuta el instalador, abre una terminal nueva y usa nvm install 22 y nvm use 22 para instalar y cambiar de versión de Node.js.
Como desarrollador, es probable que te encuentres con la necesidad de manejar múltiples proyectos de Node.js en tu entorno de desarrollo local, cada uno requiriendo diferentes versiones de Node.js. Para gestionar estos requisitos de manera eficiente, te recomendamos encarecidamente instalar Node Version Manager (NVM) en lugar de instalar Node.js directamente. NVM te permite cambiar entre versiones de Node sin problemas, asegurando que cada proyecto tenga el entorno adecuado para ejecutarse de manera efectiva. Para aquellos interesados en optimizar aún más su configuración de desarrollo, tenemos un artículo que detalla las mejores prácticas para evitar problemas comunes en el futuro.
¿Usas macOS o Linux? Sigue nuestra guía para instalar nvm en cualquier sistema operativo.
📝 Esta guía es solo para usuarios de Windows. Sigue estos enlaces si deseas instalar NVM en MacOS o instalar NVM en Linux.
Pasos para instalar NVM en Windows
1) Descarga nvm
Para poder instalar la herramienta Node Version Manager en un entorno Windows debemos descargar un archivo zip que contiene el asistente de instalación.
2) Instala nvm
Si ya tienes Node.js instalado, desinstálalo primero, como recomienda el proyecto nvm-windows. Después, anda a tu carpeta Descargas o Downloads en Windows, y descomprime el archivo nvm-setup.zip y haz doble clic en el archivo nvm-setup.
Asistente de instalación.
Cuando se abre el asistente de instalación, dale clic al botón next un par de veces y, al final verás un botón install al cual también tienes que darle clic. Después de eso, solo espera a que la barra de progreso termine.
:point_up: Recuerda no tocar la configuración predeterminada ¡Sigue dándole clic a next!!
3) Abre tu Línea de comando (o terminal)
Una vez instalado, abre la línea de comando de Windows. Si tienes algún problema en encontrar la línea de comando, escribe POWER SHELL en la barra de búsqueda de Windows en la esquina inferior izquierda de tu escritorio.
4) Instala node versión 22 o la versión que quieras
En la línea de comando, escribe los comandos que hay más abajo (nvm use activa la versión instalada). Si quieres verificar cuáles son las versiones de node actuales, puedes ir a nodejs.org y verlas todas. Nosotros te recomendamos usar la recomendada para la mayoría de los usuarios.
nvm install 22
nvm use 225) Comprueba que se instaló correctamente
Reinicia tu terminal y una vez la vuelvas a abrir, escribe el siguiente comando para comprobar que tienes node version 22:
node -vDebería salirte la versión 22
6) PowerShell en VSCode debe poder ejecutar scripts (opcional)
🔥 Solo sigue estos pasos si estás usando VSCode
Dentro de la terminal de código de VSCode, si intentas ejecutar npm desde la línea de comandos, es probable que estés recibiendo el siguiente error: no se pueden ejecutar scripts porque la ejecución de scripts está deshabilitada:
Para solucionarlo, sigue estos pasos:
- Abre la paleta de comandos escribiendo
control+shift+p. - Escribe en la paleta de comandos
User settings json. - Selecciona esa opción y se abrirá un archivo JSON para edición.
- Agrega lo siguiente a tu archivo settings.json de VSCode:
"terminal.integrated.profiles.windows": {
"PowerShell": {
"source": "PowerShell",
"icon": "terminal-powershell",
"args": ["-ExecutionPolicy", "Bypass"]
}
},
"terminal.integrated.defaultProfile.windows": "PowerShell",⚠️ Ten cuidado con el archivo JSON; asegúrate de no tener errores de sintaxis.
Posibles errores y soluciones
A continuación, se presenta una lista de problemas comunes que podrías encontrar al instalar NVM (Node Version Manager) en Windows, junto con soluciones para cada uno:
1. Error de comando no encontrado después de la instalación
Problema: 😱 Después de instalar NVM correctamente, es posible que encuentres un problema donde al ejecutar comandos nvm se muestre un error de comando no encontrado.
Solución: 😎 Esto usualmente ocurre porque la ruta de NVM no se ha agregado correctamente a las variables de entorno del sistema. Puedes agregar manualmente el directorio de NVM a tu PATH de la siguiente manera:
- Haz clic derecho en 'Este equipo' o 'Mi PC'.
- Selecciona 'Propiedades'.
- Haz clic en 'Configuración avanzada del sistema'.
- En la ventana de 'Propiedades del sistema', haz clic en 'Variables de entorno'.
- En la sección 'Variables del sistema', busca y selecciona la variable 'Path' y haz clic en 'Editar'.
- Agrega la ruta de la instalación de NVM, normalmente
C:\Users\<Tu-Usuario>\AppData\Roaming\nvm. - Haz clic en 'Aceptar' para guardar los cambios y cierra todas las ventanas.
2. El instalador no configura las variables de entorno
Problema: 😱 A veces, incluso si la instalación se completa correctamente, NVM podría no funcionar porque el instalador no configura las variables de entorno necesarias.
Solución: 😎 Verifica que las variables de entorno se hayan configurado correctamente. Si no es así, agrega manualmente NVM_HOME y NVM_SYMLINK a las variables de entorno de tu sistema:
NVM_HOMEdebe apuntar al directorio donde está instalado NVM.NVM_SYMLINKdebe ser la ruta del enlace simbólico a la versión activa de Node.js (por defectoC:\Program Files\nodejs).- Asegúrate de agregar también estas rutas a la variable 'Path', como se describe en la solución anterior.
3. Acceso denegado durante la instalación
Problema: 😱 La instalación falla con un mensaje de error 'Acceso denegado'. Solución: 😎 Esto puede ocurrir si no tienes privilegios de administrador en tu computadora. Intenta ejecutar el instalador como administrador haciendo clic derecho sobre el instalador y seleccionando 'Ejecutar como administrador'.
4. Problemas al instalar versiones específicas de Node
Problema: 😱 Después de instalar NVM, al intentar instalar ciertas versiones de Node, la instalación falla. Solución: 😎 Esto puede suceder debido a problemas de red o si el número de versión de Node especificado es incorrecto. Asegúrate de tener una conexión a internet estable y verifica el número de versión. También intenta instalar otra versión para comprobar si el problema es específico de una versión en particular. A veces, ejecutar el símbolo del sistema como administrador ayuda.
5. nvm no se reconoce como un comando interno o externo
Problema: 😱 Este error suele aparecer si el símbolo del sistema estaba abierto durante la instalación y no se ha reiniciado, o si la ruta PATH no se ha actualizado correctamente. Solución: 😎 Cierra y vuelve a abrir el símbolo del sistema o reinicia tu computadora para asegurarte de que todos los cambios ambientales entren en vigor. Revisa las configuraciones de PATH como se describe en las soluciones para el 'Error de comando no encontrado después de la instalación'.
6. Incapacidad para cambiar versiones de Node
Problema: 😱 NVM instala y lista las versiones de Node correctamente, pero cambiar entre ellas parece no funcionar. Solución: 😎 Asegúrate de que cuando instales versiones de Node mediante NVM, estés ejecutando el símbolo del sistema como administrador. A veces, los problemas de permisos pueden impedir que NVM modifique correctamente los enlaces simbólicos.
7. Rendimiento lento en Windows
Problema: 😱 A veces, NVM puede ser notablemente más lento en Windows en comparación con sistemas Unix. Solución: 😎 Este es un problema conocido debido a cómo se gestionan las variables de entorno y las rutas en Windows. Minimizar la cantidad de versiones de Node instaladas y reiniciar el sistema después de realizar cambios importantes puede ayudar a mejorar el rendimiento.
Estas soluciones abordan los problemas más comunes que se enfrentan al instalar NVM en Windows, ayudándote a garantizar una configuración más fluida y una mejor gestión de diferentes versiones de Node.js.
Con NVM funcionando en Windows ya puedes cambiar de versión de Node.js según cada proyecto. Para dar el siguiente paso y construir aplicaciones completas, un curso de programación estructurado combina proyectos reales con el apoyo de mentores.
Preguntas frecuentes
¿Debo desinstalar Node.js antes de instalar NVM en Windows?
Sí, es lo que recomienda el proyecto nvm-windows. Desinstala Node.js desde la configuración de aplicaciones de Windows y borra las carpetas que queden, como C:\Program Files\nodejs y %AppData%\npm. Si no lo haces, la instalación anterior puede entrar en conflicto con las versiones que gestiona NVM y node -v mostraría una versión inesperada.
¿Cómo ver qué versiones de Node.js tengo instaladas con NVM?
Ejecuta nvm list (o su alias nvm ls) en la terminal: verás todas las versiones instaladas y un asterisco junto a la que está activa. Para consultar las versiones que puedes descargar, usa nvm list available. Después, cambia de versión con nvm use seguido del número, por ejemplo nvm use 22.
¿Por qué node -v no muestra la versión 22 después de nvm install 22?
Porque en nvm-windows nvm install solo descarga la versión; no la activa. Ejecuta nvm use 22 para que el enlace de Node.js apunte a ella y luego comprueba con node -v. Si aparece un error de permisos, abre la terminal como administrador, ya que NVM necesita crear un enlace simbólico en el sistema.
¿Cómo desinstalar NVM en Windows?
Desinstala «NVM for Windows» desde la configuración de aplicaciones de Windows, como cualquier otro programa. Después comprueba que se hayan borrado la carpeta C:\Users\<Tu-Usuario>\AppData\Roaming\nvm, la carpeta del enlace de Node.js indicada en NVM_SYMLINK y las variables de entorno NVM_HOME y NVM_SYMLINK. Al terminar, cierra la terminal o reinicia el equipo.