Instalación de Node.js en Windows

Artículo
12/20/2023

Si es la primera vez que usa Node.js para sus desarrollos y desea empezar a aprender rápidamente, siga los pasos que se indican a continuación para instalar Node.js directamente en Windows.

Nota

Si usa Node.js para fines profesionales, si es importante encontrar la velocidad de rendimiento y la compatibilidad de llamadas del sistema, si desea ejecutar contenedores de Docker que aprovechen las áreas de trabajo de Linux y eviten tener que mantener scripts de compilación de Linux y Windows, o simplemente prefiere usar una línea de comandos de Bash, instale Node.js en el Subsistema de Windows para Linux (más concretamente en WSL 2).

Instalación de nvm-windows, node.js y npm

Además de elegir si se desea realizar la instalación en Windows o WSL, al instalar Node.js es preciso elegir más opciones. Se recomienda usar un administrador de versiones, ya que las versiones cambian con mucha rapidez. Es probable que tenga que de versión de Node.js en función de las necesidades de los distintos proyectos en los que trabaje. El administrador de versiones de Node, más comúnmente denominado nvm, es la forma más habitual de instalar varias versiones de Node.js, pero solo está disponible para Mac/Linux y no se admite en Windows. En su lugar, se recomienda instalar nvm-windows y, a continuación, usarlo para instalar Node.js y el Administrador de paquetes de nodos (npm). Hay administradores de versiones alternativos para tener en cuenta, que también se tratan en la sección siguiente.

Importante

Siempre se recomienda quitar cualquier instalación existente de Node.js o npm del sistema operativo antes de instalar un administrador de versiones, ya que los distintos tipos de instalación pueden provocar conflictos extraños y confusos. Esto incluye la eliminación de los directorios de instalación Node.js existentes (por ejemplo, "C:\Archivos de programa\nodejs") que puedan permanecer. El elemento symlink generado de NVM no sobrescribirá un directorio de instalación existente (ni siquiera vacío). Para obtener ayuda con la eliminación de instalaciones anteriores, consulta Cómo eliminar node.js completamente de Windows.

Advertencia

NVM está diseñado para instalarse por usuario e invocarse por shell. No está diseñado para cuadros de desarrolladores compartidos ni para servidores de compilación con varios agentes. NVM funciona mediante un vínculo simbólico. El uso de NVM en escenarios compartidos crea un problema ya que ese vínculo apunta a la carpeta de datos de la aplicación de un usuario, por lo que si el usuario "x" ejecuta nvm use lts, el vínculo apuntará el nodo de todo el cuadro hacia la carpeta de datos de la aplicación. Si el usuario "y" ejecuta el nodo o NPM, se le dirigirá para que ejecute los archivos en la cuenta de usuario de "x" y, en el caso de npm -g, modificarán los archivos de "x" lo que, de forma predeterminada, no está permitido. Por lo tanto, NVM solo es recomendable para un cuadro de desarrollador. Esto también es válido para los servidores de compilación. Si dos agentes de compilación están en la misma máquina virtual o cuadro, pueden entrar en competencia y provocar un comportamiento incorrecto de las compilaciones.

Siga las instrucciones de instalación en el repositorio windows-nvm. Se recomienda usar el instalador, pero si tiene una comprensión más avanzada de sus necesidades, puede considerar la instalación manual. El instalador le apuntará a la página de versiones de la versión más reciente.
Descarga el archivo nvm-setup.zip de la versión más reciente.
Una vez descargado, abre el archivo ZIP y el archivo nvm-setup.exe.
El Asistente para instalación de Setup-NVM-for-Windows te guiará por los pasos de configuración, como la elección del directorio donde se instalarán nvm-windows y Node.js.
Una vez completada la instalación. Abra PowerShell (se recomienda abrir con permisos de administrador elevados) e intente usar windows-nvm para mostrar qué versiones de Node están instaladas actualmente (en este momento no debe haber ninguna): nvm ls
Instala la versión actual de Node.js (para probar las mejoras de las características más recientes, pero es más probable que tengas más problemas que con la versión de LTS): nvm install latest
Instala la versión de LTS estable más reciente de Node.js (recomendada); para ello, primero debes buscar el número de versión de LTS actual con: nvm list available y, a continuación, instalar el número de versión de LTS con: nvm install <version> (reemplazando <version> por el número, es decir: nvm install 12.14.0).
Enumera qué versiones de Node están instaladas: nvm ls... ahora deberías ver las dos versiones que acabas de instalar.
Después de instalar los números de versión de Node.js necesarios, selecciona la versión que quieras usar. Para ello, escribe nvm use <version> (reemplaza <version> por el número, es decir, nvm use 12.9.0).
Para cambiar la versión de Node.js que deseas usar para un proyecto, crea un directorio de proyecto mkdir NodeTest, escribe el directorio cd NodeTest y, a continuación, escribe nvm use <version>, reemplazando <version> por el número de versión que te gustaría usar (por ejemplo, v10.16.3).
Comprueba qué versión de npm está instalada con: npm --version; este número de versión cambiará automáticamente a cualquier versión de npm que esté asociada a la versión actual de Node.js.

Administradores de versiones alternativos

Aunque windows-nvm es actualmente el administrador de versiones más popular para Node, existen alternativas que se deben tener en cuenta:

nvs (conmutador de versiones de Node) es una alternativa nvm multiplataforma con la capacidad de integrarse con VS Code.
Volta es un nuevo administrador de versiones del equipo de LinkedIn que notifica la velocidad mejorada y la compatibilidad multiplataforma.

Para instalar Volta como administrador de versiones (en lugar de windows-nvm), consulta la sección Instalación de Windows de su Guía de introducción; después, descarga y ejecuta Windows Installer siguiendo las instrucciones de configuración.

Importante

Debes asegurarte de que el modo de desarrollador está habilitado en el equipo Windows antes de instalar Volta.

Para más información sobre el uso de Volta para instalar varias versiones de Node.js en Windows, consulta los documentos de Volta.

Instalar Visual Studio Code

Se recomienda instalar Visual Studio Code para desarrollar con Node.js en Windows. Para obtener ayuda, consulte Tutorial de Node.js en Visual Studio Code.

Otros editores de código

Si prefiere usar un editor de código o un IDE que no sea Visual Studio Code, las siguientes opciones también son válidas para el entorno de desarrollo Node.js:

Instalación de Git

Si planeas colaborar con otras personas u hospedar el proyecto en un sitio de código abierto (como GitHub), VS Code admite el control de versiones con GIT. La pestaña Control de código fuente de VS Code realiza un seguimiento de todos los cambios y tiene comandos GIT comunes (agregar, confirmar, enviar cambios e incorporar cambios) integrados directamente en la interfaz de usuario. Primero, debes instalar GIT para alimentar el panel de control de código fuente.

Descarga e instala GIT para Windows desde el sitio web git-scm.
Se incluye un asistente para instalación que te formulará una serie de preguntas sobre la configuración de la instalación de GIT. Te recomendamos que uses todas las opciones de configuración predeterminadas, a menos que tengas un motivo concreto para cambiar algo.
Si nunca has trabajado con GIT, las guías de GitHub pueden resultarte de ayuda para empezar.
Se recomienda agregar un archivo .gitignore a los proyectos de Node. Aquí tienes la plantilla de gitignore predeterminada de GitHub para Node.js.

Uso del Subsistema de Windows para Linux para producción

Usar Node.js directamente en Windows es ideal para aprender y experimentar con lo que puedes hacer. Una vez que estés preparado para compilar aplicaciones web listas para producción, que normalmente se implementan en un servidor basado en Linux, se recomienda usar el Subsistema de Windows para Linux versión 2 (WSL 2) para desarrollar aplicaciones web Node.js. Muchos marcos y paquetes de Node.js se crean con un entorno *nix en mente, y la mayoría de las aplicaciones Node.js se implementan en Linux, por lo que el desarrollo en WSL garantiza la coherencia entre los entornos de desarrollo y producción. Para configurar un entorno de desarrollo de WSL, consulta Configurar el entorno de desarrollo de Node.js con WSL 2.