¿Cómo crear tu primer repositorio con Git?

Crear tu primer repositorio con Git significa ejecutar git init dentro de una carpeta para que Git empiece a rastrear todos los cambios de tus archivos.

Con ese único comando, Git convierte cualquier carpeta normal en un repositorio local. A partir de ese momento, puedes registrar cada versión de tu proyecto.

¿Qué es un repositorio?

Un repositorio es una carpeta que Git vigila de forma activa. Contiene tus archivos y también el historial completo de cada cambio que hayas registrado.

Puedes tener tantos repositorios como proyectos tengas. Cada uno es independiente.

La estructura que Git crea internamente

Cuando ejecutas git init, Git crea una carpeta oculta llamada .git dentro de tu proyecto. Nunca debes borrar ni modificar esa carpeta manualmente.

Adentro de .git viven los siguientes elementos clave:

No necesitas entrar a esa carpeta. Git la administra por ti de forma automática.

El flujo básico de Git

Antes de ver los comandos, entiende el flujo. Git divide el trabajo en tres zonas:

1. Área de trabajo — tus archivos tal como los editas.
2. Área de preparación (staging) — los cambios que marcaste para incluir en el próximo commit.
3. Repositorio local — el historial permanente de commits guardados.

Siempre sigues el mismo orden: editar → preparar → confirmar.

Ejemplo 1 — Repositorio básico desde cero

Imagina que trabajas en una empresa de logística en Guadalajara y creas un proyecto llamado reporte-ventas.

Paso 1: Crea la carpeta y entra en ella.

mkdir reporte-ventas
cd reporte-ventas

Paso 2: Inicializa el repositorio.

git init

Git responde con algo similar a:

Initialized empty Git repository in /Users/tu-usuario/reporte-ventas/.git/

Eso confirma que el repositorio ya existe. La carpeta .git está lista.

Paso 3: Crea un archivo de prueba.

echo "Reporte de ventas Q1" > resumen.txt

Paso 4: Revisa el estado del repositorio.

git status

Git muestra resumen.txt como un archivo sin rastrear (untracked). Aún no está en el área de preparación.

Paso 5: Agrega el archivo al área de preparación.

git add resumen.txt

Paso 6: Confirma el cambio con un commit.

git commit -m "Agrega resumen inicial de ventas Q1"

Git responde con algo como:

[main (root-commit) a3f1c2d] Agrega resumen inicial de ventas Q1
 1 file changed, 1 insertion(+)

Ya tienes tu primer commit registrado en el historial.

Ejemplo 2 — Proyecto con varios archivos

Ahora imagina un proyecto más real: una aplicación de inventario para una tienda similar a Liverpool. Tu carpeta tiene tres archivos.

inventario-liverpool/
  productos.py
  categorias.py
  README.md

En lugar de agregar archivo por archivo, usas:

git add .

El punto (.) indica "agrega todos los archivos nuevos o modificados del directorio actual". Luego confirmas:

git commit -m "Estructura inicial del sistema de inventario"

Esto registra los tres archivos en un solo commit limpio.

Ejemplo 3 — Edición y segundo commit

Continuando con el proyecto anterior, modificas productos.py para agregar una función nueva. Guardas el archivo y luego sigues el flujo:

git status

Git muestra productos.py como modificado. Lo preparas:

git add productos.py

Y confirmas el cambio con un mensaje descriptivo:

git commit -m "Agrega función para calcular precio con IVA"

Ahora tienes dos commits en el historial. Cada uno representa un punto exacto en la evolución del proyecto.

Cómo revisar el historial de commits

El comando git log muestra todos los commits que has registrado, del más reciente al más antiguo.

git log

La salida típica se ve así:

commit b7e4d1a2c3f0...
Author: Ana Martínez <ana@empresa.com.mx>
Date:   Lun Ene 20 10:32:00 2025 -0600

    Agrega función para calcular precio con IVA

commit a3f1c2d...
Author: Ana Martínez <ana@empresa.com.mx>
Date:   Lun Ene 20 09:15:00 2025 -0600

    Estructura inicial del sistema de inventario

Cada commit tiene un identificador único (el hash largo de letras y números), el autor, la fecha y el mensaje.

Si el historial es muy largo, usa la versión compacta:

git log --oneline

Eso muestra solo el hash corto y el mensaje de cada commit. Es mucho más fácil de leer cuando tienes decenas de cambios.

Cómo escribir buenos mensajes de commit

Un mensaje de commit debe describir qué cambiaste y por qué, no cómo lo hiciste. El código ya muestra el cómo.

Mensajes malos:

• cambios
• arreglé cosas
• commit final

Mensajes buenos:

• Corrige error de cálculo en descuentos de temporada
• Agrega validación de RFC en formulario de proveedores
• Actualiza precio mínimo de envío a $150

Usa el modo imperativo: "Agrega", "Corrige", "Elimina". Es la convención más usada en equipos profesionales.

Errores comunes

Error 1: Hacer commit sin pasar por git add.

Si solo ejecutas git commit sin preparar los archivos primero, Git no tiene nada que confirmar. Siempre debes usar git add antes.

# Incorrecto: salta el paso de preparación
git commit -m "Agrego archivo nuevo"

# Correcto
git add nuevo-archivo.py
git commit -m "Agrego módulo de reportes"

Error 2: Usar git add . sin revisar git status primero.

El punto agrega todo sin distinción. Puedes incluir accidentalmente archivos temporales, contraseñas o configuraciones locales que no deben estar en el historial. Revisa git status antes de hacer un git add . masivo.

Error 3: Escribir mensajes de commit vagos.

Mensajes como fix o update no tienen ningún valor informativo. Dos meses después, nadie sabrá qué se arregló ni por qué. Un buen mensaje ahorra horas de investigación futura.

Error 4: Inicializar Git dentro de otra carpeta Git.

Si ya tienes un repositorio y ejecutas git init en una subcarpeta, creas un repositorio anidado. Eso genera conflictos difíciles de resolver. Verifica siempre con git status en qué nivel estás antes de ejecutar git init.

Referencia rápida de comandos

Puntos clave de esta lección

• git init convierte cualquier carpeta en un repositorio local. Solo necesitas ejecutarlo una vez por proyecto.
• La carpeta oculta .git es el corazón del repositorio. Nunca la borres ni la edites manualmente.
• El flujo siempre es el mismo: editar → git add → git commit. Saltarte un paso rompe el ciclo.
• git status es tu mejor herramienta de diagnóstico. Úsalo antes y después de cada operación para saber exactamente en qué estado está tu proyecto.
• Los mensajes de commit deben ser descriptivos y en modo imperativo. Un buen mensaje vale más que cualquier comentario en el código.