La instalación de Node.js en Windows crea un entorno conveniente y flexible para desarrollar aplicaciones JavaScript: desde scripts simples hasta sistemas del lado del servidor. En este artículo se describen paso a paso las etapas clave de la instalación y configuración, así como consejos para trabajar con npm. Gracias a estos pasos preparatorios podrá iniciar rápidamente su primer proyecto y organizar un entorno cómodo para el desarrollo posterior.
Preparación para la instalación de Node.js
Antes de comenzar la instalación, conviene familiarizarse con algunos conceptos básicos. Node.js es un entorno de ejecución de JavaScript basado en el motor V8, que permite ejecutar código JavaScript no solo en el navegador, sino también en el servidor o como herramienta de automatización. La instalación de Node.js en Windows es tan sencilla como la de cualquier otra aplicación, pero hay algunos matices que afectan la comodidad y la funcionalidad de su entorno de trabajo.
Antes de descargar el instalador, es importante decidir la versión. Node.js existe en dos ramas principales:
- Soporte a largo plazo (LTS). Las actualizaciones salen con menos frecuencia, pero la estabilidad es prioritaria.
- Versión actual (Current). Incluye las funciones más recientes, pero la estabilidad puede ser ligeramente inferior a la de LTS.
Si su objetivo es trabajar en un proyecto a largo plazo y priorizar la estabilidad, es mejor escoger la versión LTS. Si desea usar las novedades más recientes de la plataforma, puede instalar la variante Current. Para la mayoría de los proyectos de aprendizaje y producción, la opción LTS es la más adecuada.
Por qué conviene preparar el entorno
Aunque la instalación de Node.js en Windows no requiere habilidades especiales, resulta útil planificar el entorno de trabajo con antelación. Se recomienda:
- Comprobar si dispone de permisos de administrador: en algunos equipos corporativos no será posible instalar programas sin ellos.
- Actualizar Windows a una versión reciente: para evitar problemas de compatibilidad.
- Reservar espacio en el disco duro: Node.js en sí no ocupa mucho, pero los proyectos y los paquetes de npm pueden requerir espacio adicional.
Contar con un entorno de desarrollo integrado, como Visual Studio Code, también es recomendable; sin embargo, al principio basta un editor de texto para comprobar y escribir scripts de prueba.
Descarga del instalador y comienzo de la instalación
Para iniciar la instalación, es necesario descargar el distribuidor. Se recomienda usar el sitio oficial de Node.js, donde están disponibles las versiones estables y la versión con novedades. Tras seleccionar y descargar el instalador apropiado (normalmente un archivo .msi) puede proceder con la instalación.
- Ejecute el archivo .msi. Si aparece la solicitud del control de cuentas de usuario de Windows, confirme el permiso para instalar.
- En la pantalla de bienvenida haga clic en «Siguiente».
- Acepte el acuerdo de licencia seleccionando «Acepto los términos» y vuelva a pulsar «Siguiente».
- Elija la carpeta de instalación. Por defecto es C:Program Files
odejs. Puede dejar esta ruta si no tiene motivos para cambiarla. - Indique los componentes necesarios. La mayoría de los usuarios mantiene las opciones predeterminadas, incluyendo la instalación de npm junto con Node.js y la adición de rutas a las variables de entorno.
- Pulse «Instalar» y espere a que finalice el proceso.
Al terminar la instalación, el instalador añade Node.js y npm a la variable de entorno PATH. Esto significa que para ejecutar Node.js y npm no hace falta escribir rutas manualmente: basta abrir la línea de comandos o PowerShell y ejecutar los comandos deseados.
Instalación alternativa con nvm para Windows
Para desarrolladores que necesiten usar varias versiones de Node.js en la misma máquina existe la herramienta nvm for Windows. Permite cambiar rápidamente entre distintas versiones de Node.js, lo cual es útil para probar compatibilidad o trabajar en varios proyectos. Tras instalar nvm para Windows, las órdenes para instalar Node.js se reducen a unas pocas líneas en PowerShell o CMD:
nvm install 16.15.1 nvm use 16.15.1
De este modo no necesita reinstalar Node.js: basta indicar la versión deseada y activarla.
Comprobación de que la instalación es correcta
Cuando el instalador termine, conviene verificar que todo se instaló correctamente. Abra la línea de comandos (CMD) o PowerShell y ejecute los siguientes comandos:
node -v npm -v
Si todo está instalado correctamente, la consola mostrará el número de versión de Node.js y el de npm. Por ejemplo:
C:Users
ombre_Usuario>node -v v16.15.1 C:Users
ombre_Usuario>npm -v 8.5.5
Si aparece un error o la orden no se reconoce, compruebe que las rutas a Node.js y npm están añadidas a la variable de entorno PATH. Para ello:
- Vaya al «Panel de control» → «Sistema y seguridad» → «Sistema» → «Configuración avanzada del sistema».
- Abra «Variables de entorno…» → en la lista de «Variables del sistema» busque PATH y haga doble clic para editarla.
- Compruebe que la ruta a la carpeta de Node.js (por ejemplo, C:Program Files
odejs) está presente. - Si es necesario, añada la ruta correspondiente y reinicie la ventana de la línea de comandos.
Qué es npm y cómo configurarlo
npm (Node Package Manager) es el gestor de paquetes que permite instalar módulos, librerías y herramientas para desarrollar proyectos en JavaScript. Gestiona automáticamente las dependencias y controla las versiones del código incluido, lo que ahorra mucho tiempo al crear aplicaciones. Normalmente npm se instala junto con Node.js, por lo que no se requieren pasos adicionales para empezar. No obstante, hay algunas configuraciones útiles que conviene conocer desde el inicio.
Comandos básicos de npm
Trabajar con npm es cómodo mediante un conjunto de comandos básicos:
- npm init — inicializa un nuevo proyecto y crea el archivo package.json.
- npm install <package-name> — instala localmente el paquete indicado (por defecto en la carpeta node_modules del proyecto).
- npm install -g <package-name> — instala el paquete de forma global, para que el comando esté disponible desde cualquier lugar.
- npm update — actualiza los paquetes del proyecto a las últimas versiones compatibles.
- npm uninstall <package-name> — elimina el paquete.
- npm run <script-name> — ejecuta un script definido en package.json en la sección scripts.
Para acceder a funciones adicionales también puede usar npx, que viene con npm. Permite ejecutar binarios de paquetes sin instalarlos globalmente. Por ejemplo, para iniciar rápidamente un servidor de desarrollo basta con:
npx http-server
Si http-server está instalado localmente en el proyecto, la ejecución se realizará sin necesidad de instalarlo globalmente.
Configuración del archivo de configuración de npm
npm dispone de un archivo de configuración donde se guardan parámetros como la ruta del directorio global, el servidor proxy, el registro y otros. Puede ver o cambiar estos ajustes con el comando npm config. Por ejemplo:
npm config list npm config set registry "https://registry.npmjs.org/"
Si desea cambiar la ruta de instalación de paquetes globales, puede hacerlo con npm config set prefix. Pero recuerde: al modificar la ruta predeterminada es necesario ajustar la variable PATH para que los paquetes globales sigan funcionando correctamente.
Creación del primer proyecto con Node.js
Para familiarizarse con el nuevo entorno conviene crear una aplicación JavaScript sencilla, ejecutarla con Node.js y comprobar el resultado. Aquí tiene un ejemplo mínimo que confirma que todo funciona:
- Cree una carpeta, por ejemplo my-node-app.
- Abra la línea de comandos en esa carpeta y ejecute npm init -y (la opción -y omite el diálogo y rellena package.json con valores predeterminados).
- Se generará el archivo package.json, que contiene información del proyecto, scripts, dependencias, etc.
- Crear el archivo index.js en la carpeta my-node-app con el siguiente contenido:
console.log("¡Hola desde Node.js!");
Ahora vuelva a la línea de comandos o PowerShell y escriba:
node index.js
Como resultado verá en la consola la frase: ¡Hola desde Node.js!. Esto confirma que su script se ejecutó correctamente en el entorno Node.js y que está listo para escribir programas más completos.
Instalación de módulos locales y globales
Para ampliar la funcionalidad de su aplicación puede instalar paquetes desde el repositorio oficial de npm. Por ejemplo, el popular framework para crear aplicaciones del lado del servidor es Express. Para instalarlo localmente (en el proyecto actual):
npm install express
Express se añadirá a la carpeta node_modules y en package.json aparecerá la nueva dependencia. Si desea instalar una herramienta global, por ejemplo Nodemon para reiniciar el servidor automáticamente al cambiar el código, use:
npm install -g nodemon
A partir de entonces podrá ejecutar el comando nodemon desde cualquier directorio sin instalarlo en cada proyecto.
Gestión de versiones y actualización
Durante el desarrollo puede necesitar cambiar entre distintas versiones de Node.js o npm. Como se ha indicado, nvm for Windows ayuda mucho con esto. Si usa el instalador oficial, la actualización consiste en descargar la nueva versión desde el sitio de Node.js e instalarla sobre la existente.
Comprobar la versión actual y actualizar npm
A veces solo es necesario actualizar npm sin cambiar la versión de Node.js. Para ello existe un comando específico:
npm install -g npm
Esto descargará la última versión estable de npm desde el registro y reemplazará la versión del sistema. Tras finalizar puede ejecutar de nuevo npm -v para comprobar que la actualización se realizó correctamente.
Consejos para resolver posibles errores
La instalación de Node.js y npm en Windows suele ser fluida, pero en ocasiones surgen problemas. A continuación se indican las incidencias más comunes y cómo solucionarlas.
- Los comandos node o npm no se encuentran en la consola.
Asegúrese de que la ruta a la carpeta de Node.js esté añadida a las variables de entorno de Windows. A veces es necesario reiniciar el equipo o, al menos, cerrar y volver a abrir el terminal para que los cambios en PATH surtan efecto. - Errores de permisos al instalar paquetes globales.
Abra el terminal como administrador. Si no desea usar siempre permisos de administrador, configure el prefijo global (prefix) de npm en una carpeta accesible para su usuario (por ejemplo, C:UsersTuNombreAppDataRoaming
pm) y añada esa ruta a la variable PATH. - Problemas por una versión de Windows obsoleta.
Node.js se actualiza con frecuencia, y algunas versiones nuevas pueden no funcionar correctamente en sistemas muy antiguos (por ejemplo, Windows 7). Compruebe que su sistema operativo cumple los requisitos.
Ampliación de capacidades y trabajo avanzado
Instalar Node.js abre muchas posibilidades para trabajar con JavaScript, incluyendo el desarrollo de lógica de servidor, microservicios, aplicaciones web, herramientas de construcción y la automatización de tareas. A continuación se enumeran direcciones populares en las que puede profundizar una vez dominadas las herramientas básicas.
Uso de frameworks y bibliotecas
Para desarrollar aplicaciones web completas muchos optan por Express. También existen otros frameworks como Koa, Hapi, Sails y NestJS. Puede empezar instalando Express y creando una API REST sencilla:
npm install express
Luego, en su index.js:
const express = require('express'); const app = express(); const port = 3000; app.get('/', (req, res) => { res.send('¡Hola, Express!'); }); app.listen(port, () => { console.log(`Servidor en ejecución en el puerto ${port}`); });
Ejecute node index.js y abra en el navegador http://localhost:3000. ¡Felicidades, ya tiene en funcionamiento una pequeña aplicación del lado del servidor con Node.js!
Sistemas de construcción y automatización
Node.js es ideal para trabajar con sistemas de construcción del frontend. Puede instalar y configurar herramientas como Webpack, Gulp o Parcel. Todas se instalan a través de npm y, una vez instaladas, están disponibles para tareas de construcción, minificación, transformación o pruebas del código. Ejemplo de instalación de Gulp:
npm install gulp-cli -g npm install gulp -D
Después podrá crear el archivo gulpfile.js con las tareas necesarias y ejecutarlas con el comando gulp desde el proyecto.
Pruebas con Jest o Mocha
Para mantener la calidad del código y facilitar la depuración en proyectos JavaScript se usan frameworks de pruebas como Jest o Mocha. La instalación de Jest es así:
npm install --save-dev jest
A continuación puede crear archivos de prueba, por ejemplo sum.test.js:
function sum(a, b) { return a + b; } test('Prueba de la función sum', () => { expect(sum(2, 2)).toBe(4); });
Y en package.json añada en la sección scripts:
"scripts": { "test": "jest" }
Ahora el comando npm test ejecutará todas las pruebas del proyecto.
Enlaces y herramientas útiles
A continuación se recogen recursos que serán de gran ayuda para profundizar en Node.js y en el ecosistema npm:
- Sitio oficial de Node.js – aquí puede encontrar documentación, descargar las últimas versiones y conocer las novedades de la plataforma.
- Documentación de npm – guía oficial del gestor de paquetes.
- nvm for Windows – herramienta útil para gestionar varias versiones de Node.js en una sola máquina.
- Express.js – framework popular para crear aplicaciones web.
- Jest – framework de pruebas sencillo de usar.
Conclusión
Tras instalar Node.js y configurar un entorno cómodo en Windows podrá ejecutar código JavaScript en el servidor con apenas unos clics. Tras la configuración básica, npm le dará acceso a una gran variedad de herramientas y bibliotecas para ampliar las capacidades de sus aplicaciones. Las actualizaciones periódicas mantienen la plataforma al día, por lo que encontrará fácilmente documentación, ejemplos y comunidades dispuestas a ayudar.
Cuando domine los comandos y la lógica de funcionamiento de Node.js, podrá avanzar hacia la creación de microservicios, el uso de frameworks o la publicación de sus propios paquetes. Gracias a la flexibilidad y sencillez de JavaScript, este proceso no requiere manipulaciones complejas. Node.js crece con sus ideas y no impone límites estrictos en la escala de los proyectos: desde pequeñas utilidades de línea de comandos hasta aplicaciones web completas y servicios de alta carga. Este enfoque permite obtener resultados rápidos sin perder tiempo en el despliegue.
