🛠️ 1.2 · Configuración del entorno de desarrollo

⏱ 5h 00min ⚡ 80 XP 🏅 Aprendiz 📖 Fundamentos del Web FullStack
"Un buen programador no es el que mejor teclea: es el que mejor prepara su espacio antes de teclear."

🎯 Objetivo del tema

Al terminar este tema serás capaz de: Al terminar este tema tendrás instalado y funcionando un entorno completo de desarrollo: un editor de código (VS Code), un navegador con DevTools para inspeccionar (Chrome o Firefox), Node.js y npm, y Git para control de versiones. Escribirás tu primera página HTML y la servirás localmente con un servidor de desarrollo.
🎬
Video del instructor

El administrador aún no ha insertado un video para esta sección.

🗺️ Mapa del tema

Vamos paso a paso. Primero entiendes qué es un entorno de desarrollo y por qué importa. Después instalas las cinco herramientas básicas. Al final, creas tu primer proyecto y lo sirves en tu navegador. Si te pierdes, vuelve al inicio del mapa y avanza de nuevo.

1. ¿Qué es un entorno de desarrollo?

Las cinco herramientas que todo FullStack necesita y por qué cada una existe.

2. Editor de código: Visual Studio Code

Instalación, configuración mínima, extensiones recomendadas.

3. Navegador con DevTools

Chrome y Firefox: cómo abrir la consola, el inspector y la red.

4. Node.js y npm

El motor de JavaScript fuera del navegador y el gestor de paquetes.

5. Git y GitHub

Control de versiones local y remoto: tu máquina del tiempo.

6. Tu primer proyecto: Hola, mundo

Crear carpeta, escribir HTML, servir con Live Server, abrir en el navegador.

1.2.1 ¿Qué es un entorno de desarrollo?

Un entorno de desarrollo es el conjunto de herramientas que usas todos los días para escribir, probar y depurar tu código. No es solo el editor: es todo el ecosistema. Un buen entorno te hace 3 veces más rápido. Un mal entorno te frustra a diario.

Las cinco herramientas indispensables

  • Editor de código (VS Code) — donde escribes tu código.
  • Navegador con DevTools (Chrome o Firefox) — donde ves y depuras tu código ejecutándose.
  • Node.js y npm — para correr JavaScript fuera del navegador y gestionar librerías.
  • Git — para guardar versiones de tu código y trabajar en equipo.
  • Terminal (PowerShell en Windows, Terminal en macOS/Linux) — para ejecutar comandos.
⭐ Verdad incómoda: Si saltas la configuración del entorno y empiezas a programar a ciegas, vas a pasar 5 horas arreglando problemas que se resolvían en 10 minutos con la herramienta correcta.
📷 Imagen referencial: Escritorio típico de un Desarrollador FullStack Junior: editor a la izquierda, navegador a la derecha, terminal abajo.
🎬
Video del instructor

El administrador aún no ha insertado un video para esta sección.

1.2.2 Editor de código: Visual Studio Code

VS Code (Visual Studio Code) es el editor más usado del mundo según la encuesta Stack Overflow 2024. Es gratuito, de Microsoft, multiplataforma y muy extensible. Hay alternativas (Sublime Text, Atom, WebStorm), pero VS Code es el estándar de la industria para desarrollo web.

Instalación

Ve a https://code.visualstudio.com/ y descarga el instalador de tu sistema operativo (Windows, macOS o Linux). Instálalo con las opciones por defecto. En Windows, asegúrate de marcar 'Add to PATH'.

Extensiones recomendadas para empezar

ExtensiónPara qué sirve
Spanish Language PackTraduce la interfaz al español.
Live ServerRecarga tu página automáticamente al guardar cambios.
PrettierFormatea tu código con un solo atajo (Alt+Shift+F).
ESLintDetecta errores de JavaScript mientras escribes.
HTML CSS SupportAutocompletado de clases CSS en archivos HTML.
Auto Rename TagRenombra la etiqueta de cierre cuando cambias la de apertura.

Atajos que vas a usar todos los días

  • Ctrl + S — Guardar.
  • Ctrl + P — Abrir archivo por nombre (sin buscar en carpetas).
  • Ctrl + Shift + P — Paleta de comandos: cualquier acción escribiéndola.
  • Alt + flecha arriba/abajo — Mover línea arriba o abajo.
  • Ctrl + D — Seleccionar la siguiente ocurrencia de la palabra.
  • Ctrl + / — Comentar/descomentar línea.
  • Alt + Shift + F — Formatear todo el documento.
💡 Truco del editor: Si te pierdes, abre la Paleta de comandos con Ctrl+Shift+P y escribe lo que quieras hacer. Casi siempre hay un comando para eso.
🎬
Video del instructor

El administrador aún no ha insertado un video para esta sección.

1.2.3 Navegador con DevTools: tu microscopio

El navegador no es solo para ver páginas. Es tu herramienta principal de depuración. Con las DevTools (herramientas de desarrollador) puedes ver el HTML, modificar el CSS en vivo, ejecutar JavaScript, ver las peticiones de red y diagnosticar problemas de rendimiento.

Cómo abrir DevTools

  • F12 — Abre DevTools directamente.
  • Ctrl + Shift + I — Igual que F12.
  • Clic derecho > 'Inspeccionar' — Abre DevTools enfocado en el elemento que clickeaste.
  • Ctrl + Shift + J — Abre solo la consola (ideal para escribir JavaScript rápido).

Las cinco pestañas que vas a usar

PestañaPara qué sirve
ElementsVer y editar HTML y CSS en vivo.
ConsoleVer errores de JavaScript y ejecutar código rápido.
SourcesVer los archivos cargados y poner puntos de interrupción.
NetworkVer todas las peticiones HTTP (imágenes, JS, API).
ApplicationVer cookies, almacenamiento local, sesión.

Tu primer experimento con la consola

> console.log("Hola, soy la consola")
Hola, soy la consola

> 2 + 2
4

> alert("Esto lo verás en una ventana emergente")

Abre la Consola y prueba estas líneas

⭐ Hábito de programador: Si tu código no funciona y NO miras la consola, estás programando a ciegas. El 80% de los errores de un junior se ven directamente en la consola.
🎬
Video del instructor

El administrador aún no ha insertado un video para esta sección.

1.2.4 Node.js y npm: JavaScript fuera del navegador

Node.js es el motor de JavaScript de Chrome (V8) pero empaquetado para correr fuera del navegador. Permite usar JavaScript en el servidor, crear herramientas de línea de comandos, automatizar tareas y mucho más. npm (Node Package Manager) es el gestor de paquetes: te permite descargar librerías de código abierto con un solo comando.

Instalación

Ve a https://nodejs.org/ y descarga la versión LTS (Long Term Support). Es la más estable y la recomendada para producción. En Windows, el instalador añade automáticamente Node y npm al PATH. Para verificar, abre la terminal y escribe:

node --version
v20.11.1

npm --version
10.2.4

Verifica la instalación

¿Qué es npm?

npm es como una tienda de aplicaciones para programadores. Cualquiera puede publicar un paquete (paquete = librería de código) y cualquiera puede instalarlo. Hoy hay más de 2 millones de paquetes. Los frameworks más usados del ecosistema JavaScript (React, Express, Next.js, Vite) se instalan con npm.

Tu primer comando npm

# Crear carpeta de proyecto
mkdir mi-primer-proyecto
cd mi-primer-proyecto

# Inicializar proyecto con npm
npm init -y

# Instalar una librería popular (live-server)
npm install -g live-server

# Ver lo que se creó
ls -la

Inicializa un proyecto e instala live-server globalmente

💡 Cuándo usar -g: El flag -g en npm install instala el paquete de forma global, disponible desde cualquier carpeta. Úsalo solo para herramientas de línea de comandos (como live-server). Para dependencias del proyecto, no uses -g.
🎬
Video del instructor

El administrador aún no ha insertado un video para esta sección.

1.2.5 Git y GitHub: tu máquina del tiempo

Git es un sistema de control de versiones: registra cada cambio que haces en tu código. Puedes volver a una versión anterior, comparar versiones, trabajar en equipo sin pisarte los cambios. GitHub es una plataforma en la nube que hospeda tus repositorios Git y te permite colaborar con otros programadores. Es tu carta de presentación profesional.

Los tres estados de un archivo en Git

  • Modified (modificado) — cambiaste el archivo pero no lo guardaste en Git.
  • Staged (preparado) — marcaste el archivo para el próximo guardado.
  • Committed (confirmado) — el cambio quedó guardado en el historial de Git.

Los seis comandos que vas a usar el 90% del tiempo

# Ver el estado de tu proyecto
git status

# Añadir archivos al área de preparación
git add archivo.txt
git add .                # añade todos los archivos modificados

# Confirmar los cambios con un mensaje descriptivo
git commit -m "Agrego el menú de navegación"

# Ver el historial de cambios
git log --oneline

# Subir cambios al repositorio remoto (GitHub)
git push

# Traer cambios del repositorio remoto
git pull

Comandos Git esenciales

Configuración inicial (solo la primera vez)

git config --global user.name "Tu Nombre Completo"
git config --global user.email "tu.correo@ejemplo.com"
git config --global init.defaultBranch main

Configura tu identidad en Git

⭐ Verdad del mercado: Tu portafolio en GitHub vale más que tu CV. Un reclutador técnico revisa tus repos antes de llamarte a entrevista. Empieza a hacer commits desde el primer día.
📷 Imagen referencial: Las 3 herramientas principales: VS Code, navegador y terminal — vistas como herramientas de un oficio.
🎬
Video del instructor

El administrador aún no ha insertado un video para esta sección.

1.2.6 Tu primer proyecto: Hola, mundo

Es hora de juntar todo. Vamos a crear un proyecto real, escribir nuestra primera página HTML, servirla con un servidor local y verla en el navegador. Si esto te funciona, el resto del curso es pan comido.

Paso 1: crea la carpeta del proyecto

mkdir mi-primer-sitio
cd mi-primer-sitio

Crear carpeta del proyecto

Paso 2: crea el archivo HTML

Abre VS Code en esa carpeta (code . desde la terminal). Crea un archivo llamado index.html y escribe este contenido:

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Mi primer sitio web</title>
  <style>
    body {
      font-family: system-ui, sans-serif;
      max-width: 720px;
      margin: 60px auto;
      padding: 0 20px;
      background: #fafafa;
      color: #222;
    }
    h1 { color: #333; }
    .tarjeta {
      background: white;
      border: 1px solid #ddd;
      border-radius: 8px;
      padding: 20px;
      margin: 16px 0;
    }
    button {
      background: #333;
      color: white;
      border: none;
      padding: 10px 20px;
      border-radius: 4px;
      cursor: pointer;
    }
  </style>
</head>
<body>
  <h1>Hola, mundo</h1>
  <div class="tarjeta">
    <p>Esta es mi primera página web del curso.</p>
    <p>Has hecho <span id="contador">0</span> clics en el botón.</p>
    <button onclick="incrementar()">Hacer clic</button>
  </div>
  <script>
    let clics = 0;
    function incrementar() {
      clics = clics + 1;
      document.getElementById("contador").textContent = clics;
    }
  </script>
</body>
</html>

Archivo index.html

Paso 3: sirve el archivo en local

Tienes dos opciones. La más simple es abrir el archivo con doble clic en tu explorador (se abre con file://). La más profesional es usar la extensión Live Server de VS Code: clic derecho sobre el archivo > 'Open with Live Server'. Tu página se abrirá en http://127.0.0.1:5500 y se recargará cada vez que guardes cambios.

Paso 4: verifica en el navegador

  • Abre la página en el navegador (Chrome o Firefox).
  • Verás tu 'Hola, mundo' centrado, con la tarjeta blanca y el botón.
  • Haz clic en el botón: el contador debe subir.
  • Abre DevTools (F12) > pestaña 'Elements'. Verás tu HTML.
  • Abre la pestaña 'Console'. Escribe document.title y presiona Enter.
⭐ Logro desbloqueado: Si llegaste hasta aquí y todo funciona, ya eres oficialmente una persona que desarrolla para la web. Bienvenido al curso.
🎬
Video del instructor

El administrador aún no ha insertado un video para esta sección.

📚 Contenido ampliado

Material adicional, referencias externas verificadas y ejemplos extendidos.

🤖 AI Mission

Antes de pedir a la IA, esfuérzate 3 minutos. La IA complementa, no sustituye.

Misión: Instala VS Code y las 6 extensiones recomendadas por tu cuenta, sin pedir a la IA que te guíe paso a paso. Si te atoras más de 10 minutos en algo, ENTONCES pregunta a la IA explicando QUÉ intentaste y QUÉ error te dio. Anota en tu cuaderno qué te atoró y cómo lo resolviste.

Pasos sugeridos

  1. Intenta instalar VS Code, Node.js y Git por tu cuenta siguiendo los pasos del tema. Anota cualquier problema.
  2. Si te atoras más de 10 minutos en un problema, documenta el error exacto (captura de pantalla o texto) antes de pedir ayuda a la IA.
  3. Cuando preguntes a la IA, pega el error y describe QUÉ hiciste. No digas solo 'no me funciona'.
  4. Compara la respuesta de la IA con lo que tú habrías intentado. ¿Coincide? ¿La IA asumió algo que tú ya habías descartado?
  5. Anota en tu cuaderno, bajo el título 'Mi diagnóstico vs la IA': ¿acertó la IA en su primera respuesta?

📓 Entregable: Capturas de pantalla de: VS Code instalado, las 6 extensiones activas, tu primer 'Hola, mundo' funcionando en el navegador, y la salida de node --version y git --version en la terminal.

🚫 Errores típicos de razonamiento

Error 1: Instalar el editor pero nunca personalizarlo: vivir a disgusto con tu herramienta principal.
Por qué: VS Code tiene miles de configuraciones. Si no inviertes 30 minutos en elegir tema, tipografía, atajos y extensiones que te gusten, vas a sufrir 8 horas al día. Tu editor es tu oficina: amobla la antes de mudarte.
Error 2: Programar directamente sobre file:// sin servidor local.
Por qué: Muchas APIs modernas (fetch, módulos ES6, service workers) NO funcionan con file:// por restricciones de seguridad del navegador. Vas a pensar que tu código está mal cuando en realidad es el protocolo. Usa siempre un servidor local (Live Server, http-server, o Vite).
Error 3: No leer los mensajes de error de la consola.
Por qué: Los mensajes de error de JavaScript SÍ te dicen qué pasa y en qué línea. Dice 'Uncaught ReferenceError: boton is not defined at line 12'. Eso es suficiente para encontrar el problema en 30 segundos. Si ignoras la consola, vas a pasar 3 horas adivinando.
Error 4: Pedirle a la IA 'hazme el proyecto completo' desde el primer día.
Por qué: Si la IA te genera todo el código y tú solo lo copias, no aprendes nada. Y cuando algo falle (algo va a fallar), no vas a saber arreglarlo. La IA es buena para explicar, no para sustituir tu escritura. Escribe tú, y si te atoras, pregunta dudas concretas.
Error 5: Olvidar hacer commits pequeños y frecuentes en Git.
Por qué: Un commit por día con 200 líneas es inútil cuando algo se rompe. Un commit cada 30 minutos con 10 líneas es oro: puedes volver atrás sin perder trabajo. Escribe mensajes descriptivos: 'Arreglo validación de formulario' es mil veces mejor que 'cambios'.

🧪 Laboratorio práctico

Configurar bien es la mitad del trabajo. Programa el resto.

Laboratorio: Tu primer Hola, mundo con control de versiones

Objetivo: Configurar tu entorno completo, crear un proyecto 'Hola, mundo' con HTML y JavaScript, y publicarlo en GitHub. Al final tendrás tu primer repositorio público: el inicio de tu portafolio.

Pasos

  1. Instala VS Code, Node.js, Git siguiendo los pasos del tema.
  2. Instala las 6 extensiones recomendadas.
  3. Crea una carpeta llamada mi-primer-sitio y ábrela con VS Code (code .).
  4. Crea el archivo index.html con el ejemplo del tema (Hola, mundo + contador).
  5. Instala la extensión Live Server y úsala para abrir el archivo (clic derecho > Open with Live Server).
  6. Abre DevTools (F12), ve a la pestaña Console y escribe: console.log('Estoy debuggeando').
  7. Inicializa Git en la carpeta: git init.
  8. Haz tu primer commit: git add . && git commit -m 'Mi primer Hola, mundo'.
  9. Crea un repositorio en GitHub (github.com/new) llamado mi-primer-sitio (público, sin README).
  10. Conecta tu repositorio local con el remoto y sube tu código: git remote add origin https://github.com/TU-USUARIO/mi-primer-sitio.git && git push -u origin main.
  11. Toma captura de pantalla de tu repositorio público en GitHub.

📓 Entregable: Capturas de pantalla de: (1) VS Code con index.html abierto, (2) la página funcionando en el navegador con el contador, (3) la consola de DevTools mostrando tu mensaje, y (4) tu repositorio público en GitHub con el commit inicial.

📓 Tu cuaderno: Anota pseudocódigo, diagramas, errores que encontraste y respuestas a "explica sin código". La escritura manual refuerza tu razonamiento. Tu profesor puede pedirte que subas fotos de páginas específicas.