Instalar Git y hacer tu primer commit

¿Alguna vez has tenido un archivo llamado "informe-final.docx", luego "informe-final-v2.docx", luego "informe-final-v2-corregido.docx", y finalmente "informe-final-v2-corregido-DEFINITIVO.docx"? Todos hemos pasado por eso. Es la forma primitiva de controlar versiones — y es un desastre total. Cuando trabajas solo ya es confuso, pero cuando trabajas con otras personas en el mismo proyecto, se convierte en una pesadilla.

Git existe para resolver exactamente este problema. Es una herramienta que guarda la historia completa de tu proyecto — cada cambio, cuándo se hizo, quién lo hizo y por qué. Es como tener un botón de "deshacer" infinito para todo tu proyecto, con la capacidad de volver a cualquier punto del pasado. Los videojuegos tienen puntos de guardado; Git es el sistema de "save points" de tu código.

### La historia de Git: por qué un finlandés enfadado cambió el mundo

Git fue creado en 2005 por Linus Torvalds — el mismo tipo que creó Linux. Linus necesitaba una forma de gestionar los cambios de miles de programadores trabajando a la vez en el código de Linux, y la herramienta que venía usando el proyecto dejó de estar disponible de un día para otro. Las alternativas libres que había entonces eran lentas y centralizadas: cada operación pasaba por un servidor.

Así que se puso a escribir la suya. El primer commit de Git es del 7 de abril de 2005, y está hecho ya con el propio Git. En unos diez días de trabajo estaba lo bastante terminado como para llevar con él el código del kernel de Linux. Hoy es la herramienta de control de versiones más usada del planeta, y no hay alternativa seria.

### Instalación de Git

Instalar Git es sencillo en ambos sistemas. Sigue las instrucciones para tu sistema operativo:

1# 🟦 Windows:
2# Opción 1: Descarga el instalador desde https://git-scm.com/download/win
3# Ejecuta el .exe y acepta los valores por defecto.
4# IMPORTANTE: en "Adjusting your PATH", elige "Git from the command line and also from 3rd-party software"
5
6# Opción 2: Si tienes winget (Windows 10+):
7winget install Git.Git
8
9# 🍎 Mac:
10# Opción 1: Ejecuta esto y macOS te ofrecerá instalar las Command Line Tools:
11git --version
12# Si no está instalado, aparecerá un diálogo para instalarlo
13
14# Opción 2: Si tienes Homebrew:
15brew install git

Después de instalar, cierra y vuelve a abrir tu terminal (o la terminal integrada de VS Code) y verifica:

1# Verifica que Git está instalado (funciona en ambos):
2git --version
3# Debería mostrar: git version 2.43.0 (o similar)

### Configuración inicial (una sola vez)

Git necesita saber quién eres para firmar tus cambios. Es como escribir tu nombre en un contrato — cada cambio que guardes llevará tu firma. Ejecuta estos dos comandos (solo una vez, en cualquier terminal):

1# Funciona igual en ambos sistemas:
2git config --global user.name "Tu Nombre"
3git config --global user.email "tu@email.com"
4
5# Para que los repos nuevos usen "main" (como GitHub):
6git config --global init.defaultBranch main
7
8# Verificar la configuración:
9git config --global --list
10# Debería mostrar tu nombre, email y defaultBranch

### Los 3 conceptos clave de Git

Git tiene una filosofía que necesitas entender antes de escribir comandos. Piensa en ello como preparar un paquete para enviar por correo:

1. 01.Working directory (tu escritorio): es tu carpeta de proyecto. Los archivos que editas, creas o borras. Es tu zona de trabajo normal.
2. 02.Staging area (la caja de envío): cuando decides qué cambios quieres guardar, los "metes en la caja" con git add. No todo lo que cambias tiene que ir en el mismo envío.
3. 03.Repository (la oficina de correos): cuando haces git commit, sellas la caja y la envías al historial. Ese punto queda guardado para siempre. Puedes volver a él cuando quieras.

### Tu primer repositorio: git init

Vamos a crear tu primer repositorio Git. Un repositorio es simplemente una carpeta que Git está vigilando — registra cada cambio que hagas dentro de ella. Para "activar" Git en una carpeta, usas git init:

1# Funciona igual en ambos sistemas:
2mkdir mi-primer-repo
3cd mi-primer-repo
4git init
5# Resultado: Initialized empty Git repository in .../mi-primer-repo/.git/

Git ha creado una carpeta oculta llamada .git/ dentro de tu proyecto. Ahí es donde guarda toda la historia. NUNCA toques esa carpeta manualmente — déjala en paz y deja que Git la gestione.

### git status: tu brújula en Git

El comando más importante mientras estás aprendiendo Git es git status. Te dice exactamente en qué estado está cada archivo: si está modificado, si está preparado para el commit, si Git lo está ignorando. Ejecútalo constantemente — es tu mapa:

1# Dentro de mi-primer-repo:
2git status
3# Resultado: On branch main, No commits yet, nothing to commit
4
5# Ahora crea un archivo:
6echo "# Mi Primer Proyecto" > README.md
7
8git status
9# Resultado: Untracked files: README.md
10# Git ve el archivo pero aún no lo "sigue"

### git add: preparar cambios

Cuando quieres incluir un cambio en tu próximo "punto de guardado", usas git add. Esto mueve el archivo del working directory a la staging area — lo metes en la caja de envío:

1# Añadir un archivo específico:
2git add README.md
3
4# Añadir TODOS los archivos modificados:
5git add .
6
7# Verificar qué está preparado:
8git status
9# Resultado: Changes to be committed: new file: README.md

### git commit: crear un punto de guardado

El commit es el acto de guardar. Sellas la caja y la archivas permanentemente. Cada commit necesita un mensaje que explique QUÉ hiciste y POR QUÉ. Es como escribir una nota adhesiva en la caja antes de enviarla:

1# Crear tu primer commit:
2git commit -m "Primer commit: añadir README con título del proyecto"
3
4# Verificar:
5git status
6# Resultado: nothing to commit, working tree clean
7
8# Ver el historial:
9git log --oneline
10# Resultado: a1b2c3d Primer commit: añadir README con título del proyecto

### Flujo completo: editar → add → commit

Veamos el flujo completo que repetirás cientos de veces en tu carrera. Vamos a hacer un segundo commit añadiendo más contenido:

1# 1. Editar archivos (crear algo nuevo)
2echo "Este proyecto es para aprender Git" >> README.md
3echo "print('hola mundo')" > script.py
4
5# 2. Ver qué cambió
6git status
7# modified: README.md, untracked: script.py
8
9# 3. Preparar los cambios
10git add .
11
12# 4. Verificar qué está en la caja
13git status
14# Changes to be committed: modified README.md, new file script.py
15
16# 5. Guardar el punto de guardado
17git commit -m "Añadir descripción al README y script inicial"
18
19# 6. Ver la historia
20git log --oneline
21# a1b2c3d Añadir descripción al README y script inicial
22# f4e5d6a Primer commit: añadir README con título del proyecto

### El archivo .gitignore: decirle a Git qué ignorar

No todo en tu proyecto debería guardarse en Git. Archivos temporales, contraseñas, carpetas enormes de dependencias... El archivo .gitignore le dice a Git: "ignora estos archivos, no los sigas". Se crea en la raíz del proyecto:

1# Crear .gitignore (funciona en ambos sistemas):
2echo "# Archivos a ignorar" > .gitignore
3echo "*.tmp" >> .gitignore
4echo "node_modules/" >> .gitignore
5echo ".env" >> .gitignore
6echo "__pycache__/" >> .gitignore
7
8# Añadir y guardar:
9git add .gitignore
10git commit -m "Añadir .gitignore con reglas básicas"