Repositorio en Git: qué es, qué tipos existen y cómo funcionan

Qué es un repositorio en Git

Repositorio Git — es una estructura de datos donde el sistema de control de versiones almacena metadatos y objetos que describen el historial de cambios de los archivos del proyecto. Cuando un desarrollador inicializa un repositorio con el comando git init, Git crea una carpeta oculta .git en la raíz del proyecto.

Dentro de esta carpeta se encuentran todos los objetos, referencias y archivos de configuración necesarios para el funcionamiento del sistema. El repositorio no está vinculado a una ubicación específica: el desarrollador puede crearlo localmente y luego vincularlo a un servidor remoto.

Git utiliza un modelo de repositorio distribuido: cada miembro del proyecto tiene una copia completa del historial en su ordenador. Esto significa que la mayoría de las operaciones (commit, ver historial, crear ramas) se realizan localmente sin contactar al servidor.

Según la documentación de Git, la arquitectura distribuida hace que el sistema sea resistente a fallos: si el servidor falla, cualquier repositorio local puede servir como fuente para restaurar el historial completo del proyecto.

Repositorio local y remoto

Repositorio local — es una copia del proyecto en el ordenador del desarrollador. Contiene todo el historial de commits, ramas y etiquetas, y permite realizar operaciones de commit, branch, merge y rebase sin conexión a la red.

Repositorio remoto — se aloja en un servidor y sirve como punto de sincronización para todos los miembros del equipo. Los desarrolladores envían sus cambios con el comando git push y recogen los cambios de otros con git pull.

La conexión entre el repositorio local y el remoto se configura mediante remote origin — la URL del servidor que se almacena en la configuración de Git. Un repositorio local puede estar vinculado a varios remotos, lo que es útil al trabajar con forks.

La principal ventaja de este modelo es que el desarrollador puede trabajar en el código sin conexión y sincronizar los cambios solo cuando esté listo para enviar el resultado.

Diferencias entre repositorio local y remoto

Cómo almacena Git los datos en un repositorio

El modelo de almacenamiento de Git es fundamentalmente diferente al de otros sistemas de control de versiones. En lugar de almacenar una lista de cambios (deltas) entre versiones, Git guarda instantáneas completas de todos los archivos del proyecto en el momento de cada commit.

Cada objeto en el repositorio se identifica mediante un hash SHA-1 único de 40 caracteres. Si el contenido de un archivo no ha cambiado entre commits, Git no crea un nuevo objeto, sino que reutiliza el existente — esto ahorra espacio.

Git utiliza cuatro tipos de objetos: blob (contenido del archivo), tree (estructura del directorio), commit (instantánea con metadatos) y tag (referencia con nombre a un commit). Todos los objetos se almacenan en la carpeta .git/objects.

Según Git Internals, el modelo de objetos de Git garantiza la integridad de los datos: cualquier cambio en el contenido de un archivo genera un nuevo hash, lo que hace imposible modificar el historial sin ser detectado.

Estructura de la carpeta .git

La carpeta .git es el corazón del repositorio. Sin ella, Git no puede rastrear cambios y un directorio normal sigue siendo solo un conjunto de archivos. Comprender la estructura de esta carpeta ayuda a diagnosticar problemas con el repositorio.

• objects/ — todos los objetos del repositorio: blobs, trees, commits, tags. Se almacenan comprimidos.
• refs/ — referencias a commits: heads (ramas), tags (etiquetas), remotes (ramas remotas).
• HEAD — archivo que apunta a la rama activa o commit actual.
• config — configuración del repositorio: URL remota, nombre de usuario, email y otros parámetros.
• index — área de staging donde Git almacena información sobre los archivos preparados para commit.
• logs/ — registros de actualización de referencias (reflog) que almacenan el historial de movimientos de HEAD y ramas.

El archivo HEAD merece especial atención. En estado normal contiene una referencia simbólica a una rama, por ejemplo ref: refs/heads/main. En estado detached HEAD apunta directamente a un commit — esto significa que los nuevos commits no estarán vinculados a ninguna rama.

Operaciones básicas con el repositorio

Trabajar con un repositorio Git implica un conjunto de operaciones básicas que el desarrollador realiza a diario. Cada operación cambia el estado del repositorio añadiendo nuevos objetos o moviendo referencias.

• git init — crea un nuevo repositorio vacío en el directorio actual. Git crea la carpeta .git con la estructura inicial.
• git clone — copia un repositorio remoto existente a la máquina local junto con todo el historial de commits.
• git add — añade cambios de archivos al área de staging (índice), preparándolos para el commit.
• git commit — crea una instantánea del proyecto basada en los datos del índice y la guarda como un nuevo objeto commit.
• git push — envía nuevos commits del repositorio local al remoto, actualizando las ramas en el servidor.
• git pull — recoge nuevos commits del repositorio remoto y los fusiona con la rama local actual.

Las operaciones push y pull son las únicas que requieren conexión al servidor remoto. Todas las demás operaciones se realizan completamente en local, lo que garantiza una alta velocidad incluso con un gran volumen de historial.

Ciclo de vida de un archivo en el repositorio

Cada archivo en el repositorio pasa por cuatro estados: untracked (no rastreado), modified (modificado), staged (preparado) y committed (confirmado). Git solo rastrea los archivos que se han añadido explícitamente mediante git add o que ya están en el historial de commits.

Comprender este modelo es la clave para trabajar eficazmente con Git. El desarrollador puede preparar selectivamente solo una parte de los archivos modificados para el commit, creando commits lógicamente completos con una descripción clara.

Plataformas populares para alojar repositorios

Los repositorios remotos suelen alojarse en plataformas especializadas que proporcionan interfaz web, sistema de control de acceso y herramientas adicionales para el desarrollo colaborativo.

• GitHub — la plataforma más grande con más de 100 millones de repositorios. Ofrece Actions, Pull Requests, Issues y Wiki. Gratuito para proyectos públicos.
• GitLab — plataforma con CI/CD integrado, Container Registry y un pipeline DevOps incorporado. Disponible como SaaS y versión self-hosted.
• Bitbucket — solución de Atlassian con integración con Jira y Trello. Popular en entornos corporativos gracias a sus flexibles ajustes de acceso.

La elección de la plataforma depende del tamaño del equipo, los requisitos de privacidad y las integraciones necesarias. Para el desarrollo móvil, a menudo se elige GitHub por su amplio soporte comunitario y su integración con herramientas CI/CD para iOS y Android.

Ejemplos de comandos para trabajar con un repositorio

Consideremos un escenario práctico: un desarrollador clona un repositorio existente, crea una nueva rama, realiza cambios y los envía al servidor. Cada comando demuestra el trabajo con diferentes componentes del repositorio.

# Clonar un repositorio remoto
git clone https://github.com/user/mobile-app.git

# Navegar al directorio del proyecto
cd mobile-app

# Crear una nueva rama feature y cambiar a ella
git checkout -b feature/auth

# Verificar el estado de los archivos modificados
git status

# Agregar todos los cambios al área de staging
git add .

# Crear un commit con descripción
git commit -m "Add authentication module"

# Enviar cambios al repositorio remoto
git push origin feature/auth

El comando git status es uno de los más útiles en el trabajo diario. Muestra qué archivos han sido modificados, cuáles están preparados para el commit y cuáles no son rastreados por Git en absoluto.

Ver el historial de commits

Para analizar el historial del repositorio se utiliza el comando git log con varios indicadores de formato. Muestra la cronología de los commits, sus autores, fechas e identificadores SHA-1.

# Ver el historial con visualización del grafo de ramas
git log --oneline --graph --all

# Ver los cambios en un commit específico
git show a1b2c3d

# Comparar el estado actual con el último commit
git diff HEAD

# Ver el historial de un archivo específico
git log --follow src/MainActivity.kt

El indicador --graph muestra un gráfico ASCII de las bifurcaciones, lo que es especialmente útil en repositorios con trabajo activo en varias ramas. Para proyectos móviles con lanzamientos frecuentes, un gráfico visual ayuda a evaluar rápidamente la estructura del desarrollo.