Cómo instalar Node.js y gestionar entornos en Windows 11

Si trabajas con JavaScript y utilizas Windows 11, tarde o temprano vas a necesitar instalar Node.js y gestionar distintos entornos de desarrollo. Ya sea para montar una API sencilla o para levantar una arquitectura más compleja con microservicios, tener bien organizado Node.js, npm y las diferentes versiones es clave para no volverte loco con cada proyecto.

En esta guía completa vas a ver, paso a paso, cómo instalar Node.js en Windows 11, decidir si te conviene usar WSL2 o el entorno nativo, manejar varias versiones con nvm-windows y conocer alternativas como Volta o nvs. Además, revisaremos cómo preparar tu equipo con herramientas imprescindibles como Visual Studio Code y Git, y tocaremos casos más específicos como conectar Node.js con SQL Server o desplegar en Windows Server.

Elegir dónde desarrollar: Windows 11 nativo o WSL2 con Linux

Antes de descargar nada merece la pena pararse un minuto a decidir si vas a programar con Node.js directamente en Windows 11 o dentro de una distro Linux mediante WSL2. Esta elección influye en tu flujo de trabajo, en el rendimiento y en cómo se comportarán tus proyectos en producción.

El primer factor a tener en cuenta es tu nivel de experiencia y la complejidad que estás dispuesto a asumir. Si estás empezando con Node.js y quieres centrarte en aprender el lenguaje y el entorno sin demasiadas distracciones, lo más cómodo es instalar Node.js directamente en Windows 11. Es más sencillo de configurar, tendrás menos capas intermedias y te resultará más fácil seguir tutoriales básicos.

Otro punto importante es la herramienta de línea de comandos con la que te sientes más cómodo. Si eres de los que prefieren PowerShell o el clásico CMD, el entorno nativo de Windows con Node.js instalado en C:/ encaja mejor con tu forma de trabajar. Si, en cambio, te manejas mejor con Bash y comandos típicos de Linux, tiene sentido que apuestes por WSL2 y desarrolles directamente dentro de una distribución como Ubuntu o incluso adoptar herramientas como usar Oh My Zsh para exprimir tu terminal.

También deberías pensar en el tipo de servidor donde vas a desplegar tus aplicaciones. Si sabes que tu proyecto acabará ejecutándose en un Windows Server, mantener todo el ciclo de desarrollo en Windows 11 es bastante lógico porque el entorno será muy parecido al de producción. Si la producción será un servidor Linux (lo más habitual), usar WSL2 te acercará al mismo sistema operativo y evitarás sorpresas con dependencias o scripts que se comportan de forma distinta.

En cuanto al rendimiento, se habla mucho de si Linux rinde mejor que Windows para Node.js, pero el detalle clave es que tengas el código del proyecto en el mismo sistema de archivos donde está instalado Node. Si usas Node.js nativo de Windows, guarda tus proyectos en unidades de Windows (por ejemplo, C:/proyectos/node). Si usas Node dentro de Ubuntu en WSL2, trabaja dentro del sistema de archivos de Linux (por ejemplo, /home/usuario/proyecto). De este modo evitarás cuellos de botella por accesos cruzados entre sistemas de archivos.

Si además trabajas con contenedores, en un equipo con Windows 11 lo habitual es instalar Docker Desktop en el propio Windows. Para usar Docker desde WSL2 se recomienda configurarlo para integrarse con las distribuciones Linux, de manera que puedas reutilizar los mismos scripts de construcción sin mantener versiones duplicadas para Windows y Linux.

Instalar y gestionar versiones de Node.js en Windows 11 con nvm-windows

En el ecosistema Node es muy frecuente que necesites alternar entre varias versiones de Node.js porque cada proyecto puede depender de una versión distinta, sobre todo cuando trabajas con librerías que evolucionan rápido. Por eso es casi obligatorio usar un gestor de versiones.

En sistemas macOS y Linux lo más popular es nvm (Node Version Manager), pero nvm original no es compatible con Windows. En su lugar existe un port específico llamado nvm-windows que cumple la misma función y es el que se recomienda usar en Windows 11 para cambiar de versión de manera rápida y segura.

La forma más sencilla de instalar nvm-windows es utilizar su instalador oficial en formato .exe, disponible en el repositorio del proyecto. Dentro de la página de releases encontrarás un archivo ZIP llamado normalmente nvm-setup.zip que incluye el instalador. Descarga ese ZIP, ábrelo y ejecuta el archivo nvm-setup.exe.

El asistente de instalación de nvm-windows te irá guiando para elegir en qué carpeta se instalará el propio nvm y dónde se guardarán las versiones de Node.js. Si no tienes necesidades especiales, puedes dejar las rutas que vienen por defecto, que funcionan perfectamente para la mayoría de usuarios que vienen de un entorno estándar de Windows 11.

Cuando el asistente termine, abre PowerShell (idealmente con permisos de administrador) y comprueba que todo está bien ejecutando el comando nvm ls. Justo después de la instalación seguramente no aparecerá ninguna versión de Node listada, lo cual es normal porque todavía no has descargado ninguna.

Para instalar la versión más reciente disponible de Node.js basta con escribir nvm install latest. Este comando descargará la versión actual (la que ofrece las últimas características, pero también es la que puede tener más cambios recientes y, en ocasiones, algún comportamiento aún poco probado).

Si lo que quieres es la versión recomendada para producción, tendrás que buscar primero la última versión LTS (soporte de largo plazo). Puedes ver la lista completa usando nvm list available y, una vez identificado el número de la versión que te interesa, instalarla con un comando del estilo nvm install 18.17.0 (sustituyendo el número por el que corresponda en tu caso).

Cuando ya tengas varias versiones descargadas, vuelve a ejecutar nvm ls y verás un listado con todas las versiones de Node.js instaladas mediante nvm-windows. Desde ese momento puedes alternar entre ellas usando el comando nvm use seguido del número de versión, por ejemplo nvm use 18.17.0 para establecer esa versión como activa en tu sesión.

Una forma práctica de trabajar por proyectos es, al entrar en la carpeta de un proyecto concreto, lanzar nvm use versión para ajustarte a la versión para la que fue creado. Por ejemplo, podrías tener un directorio NodeTest donde usas nvm use 16.20.0, y otro proyecto más reciente en el que lanzas nvm use 20.x al empezar a trabajar, manteniendo cada entorno de desarrollo alineado con sus dependencias.

Cada vez que cambias de versión de Node con nvm-windows, se cambia también automáticamente la versión de npm asociada. Puedes comprobar qué versión de npm estás usando simplemente ejecutando npm –version en la consola; verás que el número varía según la versión de Node activa en ese momento.

Otras herramientas para gestionar versiones: nvs y Volta

Aunque nvm-windows es el gestor de versiones más popular para usuarios de Windows, no es la única opción disponible. Existen otras herramientas que puedes valorar si buscas integraciones específicas o un flujo de trabajo distinto.

Una alternativa interesante es nvs (Node Version Switcher), un gestor de versiones multiplataforma que funciona tanto en Windows como en otros sistemas. Una de sus ventajas es que puede integrarse con Visual Studio Code, lo que te permite configurar versiones de Node específicas para determinados espacios de trabajo y automatizar cambios según el proyecto que tengas abierto.

Otra opción muy comentada en los últimos años es Volta, un gestor de herramientas para JavaScript y Node.js creado por un equipo de ingeniería de LinkedIn. Volta se centra en ofrecer mayor rapidez al instalar y cambiar de versión, y también en proporcionar una experiencia coherente en diferentes plataformas.

Si te interesa probar Volta en Windows 11, basta con ir a su guía de introducción, localizar la sección dedicada a la instalación en Windows y descargar el instalador adecuado. El asistente te irá guiando por el proceso y, una vez instalado, podrás usar sus comandos para fijar versiones de Node, npm y otras herramientas por proyecto. Su documentación oficial explica con detalle cómo utilizarlo para gestionar varias versiones de Node.js dentro de un entorno Windows.

Instalación básica de Node.js y npm en Windows 11 con el instalador oficial

Aunque los gestores de versiones son casi imprescindibles para entornos profesionales, mucha gente empieza con una instalación directa de Node.js usando el instalador oficial. Este método es muy sencillo y sirve perfectamente para proyectos iniciales o para montar entornos específicos, por ejemplo, para conectar con SQL Server.

El primer paso es ir a la página oficial de Node.js y descargar el instalador de Windows en formato .msi. Verás normalmente dos opciones principales: una versión LTS (recomendada para la mayoría de usuarios, por su estabilidad y soporte prolongado) y la versión Current (que incorpora las últimas novedades, pero con un ciclo de soporte más corto y algo más de riesgo de cambios rompientes).

En la web también se muestran datos como la versión LTS actual, el calendario de lanzamientos y el estado de soporte. Desde allí se puede consultar el historial de versiones, leer las notas de lanzamiento y, si lo necesitas, descargar archivos tarball con el código fuente o binarios de versiones antiguas. En el caso de Windows, lo más común es usar directamente el MSI precompilado, que ya viene listo para instalar.

Cuando descargues el archivo .msi correspondiente a tu arquitectura (normalmente 64 bits en equipos modernos), haz doble clic para iniciarlo. El asistente te pedirá aceptar el acuerdo de licencia de Node.js, definir la carpeta donde se instalará y, si quieres, ajustar algunos componentes opcionales. Si no tienes necesidades especiales, dejar las opciones por defecto suele ser la mejor jugada para un entorno de desarrollo estándar en Windows 11.

Algo importante es que el instalador incluye también el gestor de paquetes npm, así que no tendrás que instalarlo aparte. Al terminar, cierra el asistente y abre una ventana de CMD o PowerShell para comprobar la versión de Node y npm con los comandos node –version y npm –version. Si ambos muestran un número de versión, la instalación está correctamente realizada.

Trabajar con SQL Server y el controlador de Node.js

Si tu aplicación necesita hablar con una base de datos SQL Server (ya sea en local o en Azure SQL Database), puedes usar el controlador de Node.js que se comunica mediante el protocolo TDS, un protocolo soportado por defecto por SQL Server, por lo que no tendrás que tocar configuraciones extra en el servidor de base de datos.

El módulo más utilizado para esto es tedio (tedious en inglés), una implementación en JavaScript del protocolo TDS. Lo más habitual es instalarlo desde npm, aunque si lo prefieres también puedes descargarlo directamente desde su repositorio en GitHub y añadirlo a tu proyecto manualmente.

En Windows 11, el flujo típico para probar esta integración sería primero asegurarte de que tienes instalado Node.js y npm (ya sea mediante el instalador oficial o usando un gestor de versiones como nvm-windows). Después, abres CMD o PowerShell, creas un directorio para tu proyecto con mkdir HelloWorld y entras en él con cd HelloWorld.

Dentro de esa carpeta inicializa un nuevo proyecto con el comando npm init. El asistente te hará una serie de preguntas (nombre del paquete, versión, script de inicio, etc.), pero si pulsas Intro en todas ellas se generará un package.json con valores por defecto. A continuación, instala el módulo tedioso con npm install tedious, que descargará e incluirá la librería como dependencia del proyecto.

En otros sistemas el proceso es muy similar. En Ubuntu, por ejemplo, podrías instalar Node con apt-get install node, luego instalar npm con apt-get install npm y, a partir de ahí, crear el directorio del proyecto, inicializar con npm init e instalar tedioso con sudo npm install tedious. En macOS harías algo equivalente, tras instalar Node desde el instalador .dmg.

Qué es exactamente Node.js y por qué merece la pena usarlo

Conviene recordar que Node.js no es un lenguaje de programación, aunque muchas veces se hable de él como si lo fuera. Node es un entorno de ejecución de JavaScript que amplía lo que se puede hacer con el lenguaje más allá del navegador, permitiendo usar JavaScript para el backend y para tareas de sistema.

Al ejecutar JavaScript sobre el motor V8 (el mismo que usa Google Chrome) y apoyarse en una arquitectura orientada a eventos y con operaciones de entrada/salida no bloqueantes, Node.js está especialmente bien preparado para aplicaciones que requieren muchas conexiones simultáneas, como APIs, servicios en tiempo real o chat en vivo.

Antes de que apareciera Node.js, si querías conectar tu aplicación web a una base de datos, necesitabas un lenguaje de backend adicional como PHP, Python, Ruby o C#. JavaScript se limitaba básicamente al navegador. Gracias a Node, puedes gestionar tanto el frontend como el backend usando únicamente JavaScript, lo que abre la puerta a perfiles full‑stack que trabajan con un solo lenguaje en toda la pila.

Hoy en día, una parte muy significativa de servicios y sitios web se apoyan en Node.js en alguna parte de su infraestructura. Grandes empresas de sectores muy distintos, como NASA, Twitter, Netflix, LinkedIn, PayPal, Trello, eBay, Walmart o Mozilla, lo usan en producción para mejorar tiempos de respuesta y simplificar su stack tecnológico.

Dentro de las ventajas de Node.js destaca que tiene una sintaxis sencilla, una curva de aprendizaje asequible y una comunidad enorme, que publica librerías para casi cualquier cosa que se te ocurra a través de npm. Además, su carácter multiplataforma y su filosofía sin bloqueo lo convierten en una opción muy seria para construir tanto prototipos rápidos como aplicaciones de alto rendimiento.

Requisitos previos y recomendados antes de instalar Node.js

No necesitas un equipo de última generación para trabajar con Node.js, pero sí es recomendable llegar a la instalación con ciertos conocimientos de base que te facilitarán mucho el camino. Lo primero es tener una comprensión mínima de JavaScript y su sintaxis, ya que Node amplía su uso pero no lo sustituye.

También ayuda haber tocado algún lenguaje orientado a objetos (como Java, C#, Python, etc.), porque muchas de las estructuras y patrones que verás en Node tienen raíces en ese mundo. Eso sí, tampoco hace falta que seas un experto; lo importante es que no te suene todo a chino cuando veas clases, módulos y patrones asíncronos.

En cuanto al hardware, Node.js es bastante flexible. Se ejecuta sin problemas en la mayoría de ordenadores actuales e incluso puede funcionar en dispositivos muy modestos, como placas tipo BeagleBone o Arduino YÚN. El único punto de atención es cuánta carga de trabajo simultánea y software pesado tienes en marcha en tu máquina, pero para desarrollar aplicaciones habituales no deberías tener problemas salvo que tu equipo sea de hace muchas generaciones.

En lugar de intentar dominar todo de golpe, es mejor ir avanzando poco a poco, montando pequeños proyectos y ampliándolos con nuevas funcionalidades. El ecosistema de Node evoluciona muy rápido, pero con una base sólida de JavaScript y buena documentación irás encajando las piezas sin necesidad de memorizarlo todo.

Versiones LTS frente a versiones Current en Node.js

Cuando entras en la web oficial de Node.js, normalmente verás dos ramas principales para descargar: una versión marcada como LTS (Long Term Support) y otra llamada Current. Entender la diferencia es clave para no equivocarte en tu entorno de Windows 11.

La rama LTS corresponde a una versión que lleva más tiempo en circulación, ha sido más probada y cuenta con un ciclo de mantenimiento más largo, incluyendo actualizaciones de seguridad y correcciones de errores durante unos 18 meses aproximadamente. Es la opción recomendada para la mayoría de usuarios, especialmente si vas a desplegar aplicaciones de backend estables.

La rama Current, por otro lado, incluye las últimas funcionalidades añadidas al núcleo de Node.js. Es ideal para desarrolladores avanzados que quieren experimentar con novedades y probar tecnologías recientes, pero tiene un ciclo de soporte más corto y puede introducir cambios que afecten a librerías o comportamientos ya conocidos.

En un entorno profesional, la práctica habitual es usar LTS para entornos de producción y, si necesitas probar algo muy nuevo, reservar la rama Current para entornos de test o experimentación. En Windows 11, gracias a nvm-windows o Volta, puedes tener ambas instaladas y cambiar entre ellas según lo requiera cada proyecto.

Actualizar npm y mantener el entorno al día

npm es el gestor de paquetes por defecto de Node.js y se encarga de instalar, actualizar y gestionar las dependencias de tus proyectos. Cada vez que instalas Node, viene una versión concreta de npm asociada, pero esa versión puede quedarse atrás con el tiempo.

Comprobar qué versión de npm tienes activa es tan sencillo como ejecutar npm -v o npm –version en tu consola de Windows 11. Si ves que está desactualizada o quieres asegurarte de usar la última versión estable, puedes actualizarla globalmente con el comando npm install -g npm@latest, que descargará e instalará la versión más reciente soportada para tu entorno actual.

En sistemas macOS el proceso es idéntico: compruebas la versión con npm -v y actualizas con npm install -g npm@latest desde la terminal. En un entorno Linux, además de poder actualizar npm de la misma forma, mucha gente utiliza la herramienta n (un gestor ligero de versiones de Node) con comandos como sudo npm install -g n y luego sudo n latest para ir a la versión más reciente de Node y su npm correspondiente.

Mantener npm actualizado ayuda a mejorar la gestión de dependencias, el rendimiento de las instalaciones y la compatibilidad con paquetes recientes. Especialmente en Windows 11, donde a veces aparecen problemas por módulos nativos o rutas largas, contar con una versión moderna de npm es una forma sencilla de evitar errores ya corregidos en versiones antiguas.

Elegir editor: Visual Studio Code y alternativas para Node.js en Windows 11

Para sacar partido a Node.js en Windows 11 es muy recomendable usar un entorno de edición cómodo, con soporte para JavaScript, TypeScript, depuración integrada y acceso rápido a la terminal. En este terreno, Visual Studio Code suele ser la opción más recomendada.

VS Code está disponible para Windows, se instala con un asistente muy sencillo y dispone de extensiones específicas para Node.js, depurador integrado, integración con Git y compatibilidad con WSL2, lo que resulta ideal si decides desarrollar dentro de una distribución Linux. Además, su rendimiento es muy bueno incluso en equipos no demasiado potentes.

Si por cualquier motivo prefieres otro editor o IDE, el ecosistema de Node.js convive bien con herramientas como WebStorm, Sublime Text, Atom o incluso entornos más clásicos. Lo importante es que el editor soporte correctamente JavaScript/TypeScript, ofrezca una terminal embebida o fácil acceso a la consola y permita configurar el formateo y linting según tus preferencias.

Instalar y configurar Git en Windows 11 para trabajar con Node.js

En casi cualquier proyecto serio de Node.js vas a necesitar control de versiones con Git, especialmente si colaboras con otras personas o si publicas tu código en plataformas como GitHub o GitLab. Windows 11 no trae Git de serie, así que tendrás que instalarlo.

Para hacerlo, entra en la web oficial de git-scm.com y descarga el instalador para Windows. Al ejecutarlo, verás un asistente que te hace varias preguntas sobre la configuración: editor por defecto, integración con el menú contextual, comportamiento de la línea de comandos, etc. Si no tienes preferencias claras, lo más recomendable es dejar las opciones por defecto que propone el instalador, ya que funcionan bien para la mayoría de usuarios.

Una vez instalado Git, Visual Studio Code detectará automáticamente su presencia y activará la pestaña de control de código fuente. Desde ahí podrás hacer commits, ver diferencias entre versiones, gestionar ramas y sincronizar con repos remotos sin salir del editor, lo que agiliza bastante el flujo de trabajo con proyectos Node.

Si estás empezando con Git, merece la pena echar un vistazo a las guías de GitHub, que explican de forma muy clara cómo crear tu primer repositorio, subir proyectos y colaborar con otras personas. Además, cuando crees proyectos Node.js, es buena idea añadir un archivo .gitignore que excluya carpetas como node_modules para no subirlas al repositorio. GitHub ofrece una plantilla específica de .gitignore para Node.js que puedes reutilizar en todos tus proyectos.

Desplegar aplicaciones Node.js en Windows Server

Aunque lo habitual hoy en día es desplegar aplicaciones Node.js en servidores Linux, a veces aparecen escenarios donde, por requisitos de la organización, necesitas alojar tu aplicación en Windows Server. En estos casos, la solución más común es colocar Node.js detrás de un proxy inverso.

Existen dos caminos principales: usar iisnode integrado con IIS o configurar un proxy inverso directo hacia el proceso de Node (por ejemplo, con IIS actuando como frontal y reenviando peticiones a la app Node). Estos escenarios son algo menos frecuentes y requieren cierta experiencia con la administración de Windows Server.

En general, la recomendación en el ecosistema Node es que, siempre que sea posible, despliegues en servidores Linux por simplicidad y por la enorme cantidad de documentación y ejemplos disponibles. No obstante, si tienes que quedarte en Windows Server, la combinación de Node.js, IIS y un proxy inverso te permitirá servir tus aplicaciones sin demasiados problemas, siempre que sigas las guías específicas para ese entorno.

En definitiva, si utilizas Windows 11 para desarrollar con Node.js, contar con un buen gestor de versiones como nvm-windows, elegir sabiamente entre entorno nativo y WSL2, instalar herramientas clave como Visual Studio Code y Git y mantener npm al día te dará un entorno sólido y flexible. Con estas bases podrás trabajar con múltiples proyectos, conectarte a bases de datos como SQL Server, experimentar con versiones LTS y Current y, llegado el momento, desplegar tus aplicaciones tanto en servidores Linux como en infraestructuras Windows sin tener que pelearte con incompatibilidades de entorno ni versiones desalineadas.