Directorio de trabajo vs. área de preparación vs. repositorio local: entender las tres zonas locales de Git

By Mirko Peters · 2026-08-12

Domina las tres zonas locales de Git: aprende cómo el directorio de trabajo, el área de preparación y el repositorio local funcionan juntos para darte un control preciso sobre el historial de tu proyecto.

Automatically translated with AI from the original post. Read the English original

Entender las tres áreas locales de Git (el directorio de trabajo, el área de preparación y el repositorio local) es esencial para pasar de copiar archivos de forma caótica a un control de versiones deliberado. Esta guía explica cómo funciona cada zona, como si fuera una oficina física, para darte un control preciso sobre el historial de tu proyecto.

Puntos clave

• El directorio de trabajo es la carpeta activa de tu proyecto. Funciona como un escritorio de oficina desordenado, donde editas los archivos con total libertad.
• El área de preparación actúa como una bandeja de revisión que contiene solo los cambios que seleccionas con git add para tu siguiente punto de control.
• El repositorio local hace de archivador: registra de forma permanente tus cambios preparados como un historial de commits estructurado.
• Los comandos git status y git diff son comprobaciones de seguridad que te permiten revisar lo que ocurre en tus áreas locales antes de registrar el historial.
• Entender estas tres zonas evita commits accidentales y te ayuda a mantener el historial de tu proyecto limpio y lógico.

El directorio de trabajo: tu escritorio activo

Cuando abres una carpeta de proyecto en tu equipo y empiezas a editar, estás trabajando directamente en la primera zona local de Git: el directorio de trabajo. Piensa en esta carpeta como tu escritorio físico en el trabajo. Contiene todos los archivos que abres, creas, modificas o eliminas, incluidos el código de sitios web, la documentación, los archivos de configuración y las imágenes.

Como en un escritorio real, el directorio de trabajo puede desordenarse mientras experimentas. Quizá empiezas a rediseñar un botón de inicio de sesión, notas un error ortográfico en un archivo readme y creas un script experimental para probar una nueva maquetación. Git no obliga automáticamente a que cada modificación de esta carpeta pase a formar parte de tu historial permanente. Tienes libertad para probar ideas, equivocarte y dejar trabajo sin terminar, sin alterar de forma permanente el registro de tu proyecto.

Para ver qué ha cambiado en tu directorio de trabajo desde el último punto de control registrado, usas el comando git status. En pocas palabras, pedirle a Git su estado es como hacer inventario de todo lo que hay sobre tu escritorio. Identifica los archivos modificados, nuevos y eliminados, y te muestra exactamente qué ha cambiado desde tu último commit.

El área de preparación: la bandeja de revisión

El área de preparación es quizá el concepto más malinterpretado para los desarrolladores que se inician en el control de versiones, en gran parte porque su nombre suena a un misterioso almacén técnico. En realidad, imagina el área de preparación como una bandeja de revisión situada junto a tu escritorio. En esa bandeja colocas solo los cambios que quieres incluir en tu siguiente punto de control.

Supongamos que dedicas la mañana a corregir un enlace crítico de restablecimiento de contraseña y, al mismo tiempo, empiezas un rediseño experimental de la pantalla de bienvenida. Quieres registrar sin duda la corrección de la contraseña, pero el rediseño está incompleto y tiene errores. No quieres que ambos cambios se agrupen en el mismo commit.

Al ejecutar git add seguido de tu archivo de restablecimiento de contraseña, colocas ese cambio concreto y completado en el área de preparación (staging). A pesar de su nombre, git add no guarda tu trabajo de forma permanente ni envía nada a un servidor en línea. Simplemente prepara una versión limpia y elegida de ese archivo para tu próximo punto de control. Esta pequeña pausa te da un control enorme. Puedes revisar los cambios preparados, quitar elementos que añadiste prematuramente o incorporar archivos adicionales que pertenecen exactamente a la misma unidad lógica de trabajo.

El repositorio local: el archivador

Una vez que tu bandeja de revisión contiene exactamente el conjunto de cambios que quieres conservar, esas ediciones pasan a la tercera zona de Git: el repositorio local. Si el directorio de trabajo es tu escritorio y el área de preparación es tu bandeja de revisión, el repositorio local es tu archivador seguro.

El repositorio local almacena todos tus commits y el historial del proyecto directamente en tu equipo, dentro de carpetas ocultas del sistema. Cuando ejecutas git commit -m "Fix password reset link", Git toma los cambios preparados del área de preparación y los registra en un punto de control permanente con nombre.

Esta arquitectura local primero significa que puedes construir un historial de proyecto completo y trazable sin conexión a internet ni servicio de alojamiento en línea. Todo ocurre de forma segura en tu propio hardware. Tu flujo de trabajo diario se convierte en un ritmo fiable: editas archivos en el directorio de trabajo, revisas la situación con git status, seleccionas cambios concretos con git add y registras tus decisiones con git commit.

Conclusión

Dominar la distinción entre el directorio de trabajo, el área de preparación y el repositorio local transforma la forma en que abordas los proyectos de desarrollo. Al tratar tu carpeta como un espacio de trabajo, tu área de preparación como una bandeja de revisión y tu repositorio local como un archivador permanente, obtienes un control total sobre el historial de tu proyecto.

Para profundizar en los fundamentos del control de versiones, escucha el episodio completo del podcast M365 FM para oír a Mirko Peters explicar Git en lenguaje sencillo y descubrir cómo encajan estas mecánicas locales en los flujos de trabajo de equipo más amplios.

Preguntas frecuentes

¿Cuál es la diferencia entre el directorio de trabajo y el área de preparación?

El directorio de trabajo es tu carpeta de proyecto activa, donde editas, creas y eliminas archivos libremente. El área de preparación es una bandeja de revisión selectiva en la que colocas solo los cambios concretos que quieres incluir en tu próximo commit.

¿Git add guarda mis archivos de forma permanente?

No. El comando git add prepara tus archivos moviéndolos al área de preparación, pero no los registra de forma permanente en el historial del proyecto ni los envía en línea. El registro permanente solo se produce al ejecutar git commit.

¿Puedo usar Git sin un servicio de alojamiento en línea?

Sí. Git está diseñado para funcionar completamente en local en tu equipo. Puedes crear un repositorio local, hacer commits, gestionar ramas y consultar el historial sin conectarte nunca a GitHub ni a internet.

¿Qué debo hacer si preparo un archivo por error?

Si preparas un archivo demasiado pronto, Git ofrece comandos para deshacer la preparación (como git reset) que quitan el archivo del área de preparación y lo devuelven al directorio de trabajo sin perder tus últimas ediciones.