Instalar Node.js y configurar tu entorno de desarrollo

Aprende a instalar Node.js correctamente, verificar tu entorno y organizar tus proyectos para trabajar con npm de forma profesional desde el primer día.

Antes de trabajar con npm necesitas Node.js instalado. Node.js es el entorno de ejecución que permite que tu ordenador entienda JavaScript fuera del navegador, y npm viene incluido con él.

En esta lección vamos a instalar Node.js (o verificar que ya lo tienes), actualizar npm a la última versión y configurar un directorio de trabajo limpio para tus proyectos. Estos pasos son fundamentales porque un entorno mal configurado genera problemas difíciles de diagnosticar después.

Al terminar tendrás un entorno listo para el resto del curso y sabrás cómo mantenerlo actualizado.

  • Node.js es JavaScript en el servidor y en tu máquina local.
  • Node.js es un entorno de ejecución de JavaScript construido sobre el motor V8 de Chrome. Mientras que tradicionalmente JavaScript solo se ejecutaba en navegadores, Node.js permite ejecutar JavaScript en tu ordenador, lo que abre posibilidades enormes: herramientas de desarrollo, servidores, scripts de automatización y, por supuesto, gestión de paquetes con npm.
  • npm es el gestor de paquetes que viene bundled con Node. Cuando instalas Node, automáticamente tienes acceso al comando `npm` en tu terminal. Pero no todas las instalaciones de Node incluyen la versión más reciente de npm, así que actualizarla será nuestro primer paso.
  • Node.js ejecuta JavaScript fuera del navegador
  • npm viene incluido con Node

Qué es Node.js y por qué lo necesitas

Node.js es JavaScript en el servidor y en tu máquina local.

Node.js es un entorno de ejecución de JavaScript construido sobre el motor V8 de Chrome. Mientras que tradicionalmente JavaScript solo se ejecutaba en navegadores, Node.js permite ejecutar JavaScript en tu ordenador, lo que abre posibilidades enormes: herramientas de desarrollo, servidores, scripts de automatización y, por supuesto, gestión de paquetes con npm.

npm es el gestor de paquetes que viene bundled con Node. Cuando instalas Node, automáticamente tienes acceso al comando `npm` en tu terminal. Pero no todas las instalaciones de Node incluyen la versión más reciente de npm, así que actualizarla será nuestro primer paso.

  • Node.js ejecuta JavaScript fuera del navegador
  • npm viene incluido con Node
  • Node usa el motor V8 de Chrome (muy rápido)
  • Permite crear servidores, herramientas y automatización

Cómo instalar Node.js correctamente

Elige el método que mejor se adapte a tu sistema operativo.

La forma más sencilla es descargar el instalador desde nodejs.org. El asistente de instalación configura todo automáticamente: Node, npm y las variables de entorno necesarias. En Windows el instalador también añade Node al PATH del sistema.

Sin embargo, si trabajas con diferentes proyectos que requieren versiones distintas de Node, considera usar nvm (Node Version Manager). nvm permite instalar múltiples versiones de Node y cambiar entre ellas con un comando. Esto es especialmente útil cuando mantienes proyectos antiguos que no son compatibles con versiones nuevas.

Actualizar npm a la última versión

npm se actualiza independientemente de Node.

Aunque npm viene con Node, se puede actualizar por separado. Esto es importante porque versiones recientes de npm incluyen mejoras de rendimiento, correcciones de bugs y nuevas funcionalidades. El comando es simple: `npm install -g npm@latest`.

El flag `-g` significa global: instala npm en el sistema para que esté disponible en cualquier directorio. No confundas esto con instalar paquetes de proyecto.

Organizar tus proyectos para npm

Una buena estructura de carpetas facilita el trabajo.

Cada proyecto npm vive en su propia carpeta con su propio package.json. No tienes un 'npm global' donde instalas todo junto: cada proyecto gestiona sus dependencias de forma aislada. Esto es intencional y evita conflictos entre versiones de librerías.

Mi recomendación es crear una carpeta ~/projects o ~/codigo donde vayas generando subcarpetas para cada proyecto. Así mantienes todo ordenado y sabes exactamente dónde está cada cosa.

  • Cada proyecto tiene su propia carpeta
  • Cada proyecto tiene su propio package.json
  • Las dependencias se instalan dentro del proyecto
  • Usa una carpeta raíz para todos tus proyectos

Tu primer proyecto Node/npm

Vamos a crear un proyecto desde cero y verificar que todo funciona.

Ahora que tienes Node y npm instalados y actualizados, vamos a crear tu primer proyecto. El flujo es simple: crear carpeta, entrar en ella, ejecutar npm init, y listo. Este proyecto no hace nada especial, pero te permite verificar que el entorno funciona.

En lecciones posteriores instalaremos dependencias reales y ejecutaremos scripts, pero por ahora solo necesitamos confirmar que todo está correctamente configurado.

NPM
02

Instalar Node.js y configurar tu entorno de desarrollo

Aprende a instalar Node.js correctamente, verificar tu entorno y organizar tus proyectos para trabajar con npm de forma profesional desde el primer día.

Código del tema: node -v

📘 Teoría

Qué es Node.js y por qué lo necesitas

Node.js es JavaScript en el servidor y en tu máquina local.

Node.js es un entorno de ejecución de JavaScript construido sobre el motor V8 de Chrome. Mientras que tradicionalmente JavaScript solo se ejecutaba en navegadores, Node.js permite ejecutar JavaScript en tu ordenador, lo que abre posibilidades enormes: herramientas de desarrollo, servidores, scripts de automatización y, por supuesto, gestión de paquetes con npm.

npm es el gestor de paquetes que viene bundled con Node. Cuando instalas Node, automáticamente tienes acceso al comando `npm` en tu terminal. Pero no todas las instalaciones de Node incluyen la versión más reciente de npm, así que actualizarla será nuestro primer paso.

  • Node.js ejecuta JavaScript fuera del navegador
  • npm viene incluido con Node
  • Node usa el motor V8 de Chrome (muy rápido)
  • Permite crear servidores, herramientas y automatización

Cómo instalar Node.js correctamente

Elige el método que mejor se adapte a tu sistema operativo.

La forma más sencilla es descargar el instalador desde nodejs.org. El asistente de instalación configura todo automáticamente: Node, npm y las variables de entorno necesarias. En Windows el instalador también añade Node al PATH del sistema.

Sin embargo, si trabajas con diferentes proyectos que requieren versiones distintas de Node, considera usar nvm (Node Version Manager). nvm permite instalar múltiples versiones de Node y cambiar entre ellas con un comando. Esto es especialmente útil cuando mantienes proyectos antiguos que no son compatibles con versiones nuevas.

Verificar instalación actual
# Ver versión de Node
node -v

# Ver versión de npm
npm -v

# Ver ruta del ejecutable de Node
which node

Actualizar npm a la última versión

npm se actualiza independientemente de Node.

Aunque npm viene con Node, se puede actualizar por separado. Esto es importante porque versiones recientes de npm incluyen mejoras de rendimiento, correcciones de bugs y nuevas funcionalidades. El comando es simple: `npm install -g npm@latest`.

El flag `-g` significa global: instala npm en el sistema para que esté disponible en cualquier directorio. No confundas esto con instalar paquetes de proyecto.

Actualizar npm a la última versión
# Actualizar npm globalmente a la última versión
npm install -g npm@latest

# Verificar que se actualizó
npm -v

Organizar tus proyectos para npm

Una buena estructura de carpetas facilita el trabajo.

Cada proyecto npm vive en su propia carpeta con su propio package.json. No tienes un 'npm global' donde instalas todo junto: cada proyecto gestiona sus dependencias de forma aislada. Esto es intencional y evita conflictos entre versiones de librerías.

Mi recomendación es crear una carpeta ~/projects o ~/codigo donde vayas generando subcarpetas para cada proyecto. Así mantienes todo ordenado y sabes exactamente dónde está cada cosa.

  • Cada proyecto tiene su propia carpeta
  • Cada proyecto tiene su propio package.json
  • Las dependencias se instalan dentro del proyecto
  • Usa una carpeta raíz para todos tus proyectos

Tu primer proyecto Node/npm

Vamos a crear un proyecto desde cero y verificar que todo funciona.

Ahora que tienes Node y npm instalados y actualizados, vamos a crear tu primer proyecto. El flujo es simple: crear carpeta, entrar en ella, ejecutar npm init, y listo. Este proyecto no hace nada especial, pero te permite verificar que el entorno funciona.

En lecciones posteriores instalaremos dependencias reales y ejecutaremos scripts, pero por ahora solo necesitamos confirmar que todo está correctamente configurado.

Crear primer proyecto
# Crear carpeta del proyecto
mkdir mi-primer-proyecto

# Entrar en la carpeta
cd mi-primer-proyecto

# Inicializar npm
npm init -y

# Ver el contenido
ls -la

🧪 Aprende probando

Ejemplo Demo: verificar versiones de Node y npm Ejecuta los comandos para ver qué versiones tienes instaladas.

🏁 Retos

Reto Reto: configurar tu entorno de trabajo Crea una carpeta de proyectos y un proyecto npm dentro.
Reto Reto 2: actualizar npm Actualiza npm a la última versión disponible.

¿Qué es esto?

Soy Cristian Eslava y a veces hago webs para procrastinar yo y vosotros 😉.

Esta la hice en febrero de 2026 para facilitar el aprendizaje de mis alumnxs. Aprender desarrollo web practicando. La idea es que crezca semanalmente con nuevos temas, tests y retos.

Inspirado en MDN, en W3Schools, en Codepen, en el crack de Manz y en mil sitios de documentación sobre desarrollo web. Quería aportar además de bloques teóricos con ejemplos, la gamificación de los retos y el sistema de test que ya tenía en culTest .

Si te gustó, si no te gustó, si quieres saludarme, o invitarme a 🍻 no dudes en escribirme en cristianeslava@gmail.com .