Cómo crear tu primer repositorio con Git: paso a paso desde git init hasta el primer commit

Introducción

En el mundo del desarrollo de software, Git es la herramienta de control de versiones que casi todo profesional utiliza a diario. Sin embargo, muchos iniciantes todavía se pierden al intentar crear su primer repositorio local, añadir archivos y registrar el primer commit. Este artículo está pensado para programadores junior, estudiantes o cualquier persona que necesite una guía clara y práctica para iniciar un proyecto con Git desde cero.

Al final de la lectura vas a ser capaz de:

1. Inicializar un repositorio vacío con git init.
2. Crear un archivo de ejemplo y entender su contenido.
3. Añadir ese archivo al staging area usando git add.
4. Realizar el primer commit con git commit -m "mensaje".
5. Visualizar la salida que Git muestra en cada paso y saber qué significa cada línea.

Nota: Todo el proceso se realiza en tu máquina local, sin necesidad de conectarte a un servidor remoto como GitHub o GitLab. Más adelante, si te interesa, podrás añadir el remoto sin cambiar nada de lo que ya hiciste.

1. Preparación del entorno

1.1. Verificar la instalación de Git

Antes de comenzar, asegurate de que Git está instalado y accesible desde la terminal.

git --version

La salida esperada es algo similar a:

git version 2.42.0

Si no obtenés nada o el comando no se reconoce, deberás instalar Git siguiendo la guía oficial para tu sistema operativo.

1.2. Elegir el directorio de trabajo

Decidí dónde vas a crear tu proyecto. Por ejemplo, una carpeta llamada mi-primer-repo dentro de tu directorio de documentos.

cd ~/Documentos
mkdir mi-primer-repo
cd mi-primer-repo

En este punto el árbol de directorios se ve así:

~/Documentos/mi-primer-repo

2. Inicializar el repositorio con git init

El comando git init crea un nuevo repositorio vacío, generando una carpeta oculta .git que contiene toda la información de control de versiones.

git init

Salida esperada

Initialized empty Git repository in /home/usuario/Documentos/mi-primer-repo/.git/

¿Qué significa?

• Initialized empty Git repository: Git creó la estructura interna necesaria.
• La ruta mostrada indica dónde quedó la carpeta .git.

3. Crear un archivo de ejemplo

Vamos a crear un archivo sencillo llamado README.md con un pequeño texto.

echo "# Mi primer repositorio

Este es el README de mi proyecto de ejemplo." > README.md

Verificar su contenido

cat README.md

Salida esperada:

# Mi primer repositorio

Este es el README de mi proyecto de ejemplo.

4. Añadir el archivo al staging area con git add

Git no registra cambios directamente; primero hay que pasar los archivos al staging area (área de preparación).

git add README.md

Salida esperada

git add no muestra nada cuando se ejecuta correctamente. La ausencia de mensaje indica que el archivo quedó preparado para el commit.

Verificar el estado

Para confirmar que el archivo está en staging, usá:

git status

Salida esperada:

On branch master

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)

	new file:   README.md

Interpretación:

• On branch master: todavía estás en la rama principal (en versiones recientes, puede llamarse main).
• No commits yet: aún no hay historial.
• new file: README.md: el archivo está listo para el commit.

5. Hacer el primer commit con git commit -m

El commit crea un punto en el historial que captura el estado actual del staging area.

git commit -m "Primer commit: agregar README"

Salida esperada

[master (root-commit) a1b2c3d] Primer commit: agregar README
 1 file changed, 3 insertions(+)
 create mode 100644 README.md

Desglose de la salida:

• master (root-commit) a1b2c3d: indica que es el commit raíz en la rama master y muestra el hash abreviado.
• Primer commit: agregar README: es el mensaje que proporcionaste.
• 1 file changed, 3 insertions(+): una archivo modificó, con 3 líneas nuevas.
• create mode 100644 README.md: el archivo fue creado con permisos típicos.

Ver el historial

git log --oneline

Salida esperada:

a1b2c3d (HEAD -> master) Primer commit: agregar README

6. Buenas prácticas y errores comunes

6.1. Mensajes de commit claros y concisos

• Bueno: Agregar README con descripción del proyecto.
• Malo: cambio o update.

Un buen mensaje ayuda a cualquiera (incluido vos futuro) a entender rápidamente qué y por qué se cambió.

6.2. No olvidar git add antes del commit

Si editás un archivo y ejecutás git commit sin haberlo añadido, Git te mostrará un mensaje como:

nothing to commit, working tree clean

En ese caso, simplemente corre git add <archivo> y vuelve a intentar.

6.3. Evitar usar git commit -a en el primer commit

El flag -a solo añade archivos modificados y eliminados, pero no los nuevos. Como el README.md era nuevo, git commit -a -m "msg" habría fallado al no encontrar cambios.

6.4. No mezclar git init y git clone

• git init crea un repositorio vacío.
• git clone <url> copia un repositorio existente.

Usá cada uno según el caso: si ya tenés código remoto, clónalo; si empezás desde cero, inicializá.

6.5. Configuración básica del usuario

Git necesita saber quién está haciendo los cambios. Si todavía no configuraste tu nombre y email, hacelo ahora:

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

Sin esta información, los commits quedarán sin autor y Git te advertirá.

7. Próximos pasos recomendados

1. Crear un remoto (GitHub, GitLab, Bitbucket) y conectar tu repositorio local con git remote add origin <url>.
2. Explorar ramas con git branch y git checkout -b nueva-rama.
3. Aprender a deshacer con git reset, git revert y git checkout -- <archivo>.
4. Automatizar con hooks (por ejemplo, un hook pre-commit para lint).

Con estos conceptos ya tenés la base para trabajar de forma segura y ordenada en cualquier proyecto.

Conclusión

En este tutorial paso a paso cubrimos todo lo necesario para crear un repositorio Git desde cero, añadir un archivo, pasarlo al staging area y registrar el primer commit, incluyendo la salida típica de cada comando. Aplicá estas instrucciones en tus propios proyectos y, a medida que te sientas más cómodo, explorá funcionalidades avanzadas como ramas, merges y remotos. ¡A codificar y versionar con confianza!