# Git desde cero: Tu Primer Repositorio Git es la herramienta más importante en desarrollo moderno. En esta lección aprenderás qué es, por qué la necesitas y cómo crear tu primer repositorio. ## 🎯 Objetivos de esta lección Al final de esta lección habrás: - ✅ Entendido qué es Git y por qué es fundamental - ✅ Comprendido el control de versiones - ✅ Aprendido los comandos básicos de Git - ✅ Creado tu primer repositorio local - ✅ Conocido GitHub y su importancia - ✅ Preparado para usar Git con Claude Code --- ## 🤔 ¿Qué es Git? ### Definición Simple **Git** es un sistema de control de versiones que guarda un historial completo de los cambios en tu código. ### Analogía: El "Ctrl+Z" Infinito Imagina que estás escribiendo un documento importante: **Sin Git:** ``` documento.docx documento_final.docx documento_final_FINAL.docx documento_final_FINAL_definitivo.docx documento_final_FINAL_definitivo_AHORA_SI.docx ``` **Con Git:** ``` documento.docx ├── Versión 1: Borrador inicial (ayer) ├── Versión 2: Añadí introducción (hoy 9am) ├── Versión 3: Corregí errores (hoy 11am) └── Versión 4: Versión final (hoy 2pm) Puedes volver a CUALQUIER versión en cualquier momento ``` --- ## 🎯 ¿Para Qué Sirve Git? ### 1. Historial Completo de Cambios ```bash $ git log --oneline a3f2b1c (HEAD) Añadir función de login 8d4e5f6 Corregir bug en formulario 2c1a9b3 Crear página de inicio 7f8e2d1 Commit inicial ``` Puedes ver: - ✅ Qué cambió - ✅ Quién lo cambió - ✅ Cuándo se cambió - ✅ Por qué se cambió (mensaje del commit) ### 2. Trabajo en Equipo ``` ┌─────────┐ │ Proyecto│ └────┬────┘ │ ┌─────┴─────┐ │ │ Ana trabaja Carlos trabaja en login en dashboard │ │ └─────┬─────┘ │ Git combina los cambios automáticamente ``` ### 3. Experimentar Sin Miedo ``` Rama Principal (main) ├── [Código estable en producción] Rama Experimental (nueva-feature) ├── [Pruebas nuevas ideas] └── Si funciona → fusionar con main Si falla → eliminar la rama ``` ### 4. Backups Automáticos ``` Tu Computadora ←→ GitHub (nube) Si tu computadora falla: ✅ Todo tu código está respaldado en GitHub ``` --- ## 📋 Conceptos Básicos de Git ### 1. Repositorio (Repo) Un **repositorio** es una carpeta de proyecto rastreada por Git. ``` mi-proyecto/ ├── .git/ ← Carpeta oculta de Git (historial) ├── src/ │ ├── index.js │ └── utils.js ├── package.json └── README.md ``` ### 2. Commit Un **commit** es una "fotografía" de tu código en un momento específico. ``` Commit 1: "Crear estructura inicial" ├── index.html └── style.css Commit 2: "Añadir JavaScript" ├── index.html ├── style.css └── app.js ← NUEVO Commit 3: "Corregir bug en app.js" ├── index.html ├── style.css └── app.js ← MODIFICADO ``` ### 3. Staging Area (Área de Preparación) ``` ┌─────────────────┐ │ Working │ 1. Editas archivos │ Directory │ └────────┬────────┘ │ git add ┌────────▼────────┐ │ Staging Area │ 2. Preparas cambios └────────┬────────┘ │ git commit ┌────────▼────────┐ │ Repository │ 3. Guardas en historial └─────────────────┘ ``` ### 4. Ramas (Branches) ``` main: A---B---C---D \ \ feature: E---F---G ``` - `main`: Rama principal (código estable) - `feature`: Rama para nueva característica --- ## 🖥️ Comandos Básicos de Git ### Configuración Inicial (Una Sola Vez) ```bash # Configurar nombre git config --global user.name "Tu Nombre" # Configurar email git config --global user.email "tu@email.com" # Verificar configuración git config --list ``` ### Crear un Repositorio **Opción 1: Proyecto Nuevo** ```bash # Crear carpeta mkdir mi-proyecto cd mi-proyecto # Inicializar Git git init Salida: Initialized empty Git repository in /ruta/mi-proyecto/.git/ ``` **Opción 2: Clonar Proyecto Existente** ```bash # Descargar desde GitHub git clone https://github.com/usuario/proyecto.git ``` ### Flujo de Trabajo Básico **1. Ver Estado** ```bash $ git status On branch main Changes not staged for commit: modified: index.html Untracked files: app.js ``` **2. Añadir Archivos al Staging** ```bash # Añadir archivo específico git add index.html # Añadir todos los archivos git add . # Añadir archivos por patrón git add *.js ``` **3. Hacer Commit** ```bash git commit -m "Descripción de los cambios" # Ejemplo git commit -m "Añadir página de login" ``` **4. Ver Historial** ```bash # Historial completo git log # Historial resumido git log --oneline # Últimos 5 commits git log -5 ``` --- ## 🎯 Ejercicio Práctico: Tu Primer Repositorio ### Paso 1: Crear el Proyecto ```bash # Crear carpeta mkdir mi-primer-repo cd mi-primer-repo # Inicializar Git git init ``` ### Paso 2: Crear Archivos ```bash # Crear README echo "# Mi Primer Proyecto Git" > README.md # Crear archivo HTML echo "

Hola Git

" > index.html ``` ### Paso 3: Primer Commit ```bash # Ver estado git status # Añadir archivos git add . # Hacer commit git commit -m "Commit inicial: añadir README e index.html" ``` ### Paso 4: Hacer Más Cambios ```bash # Crear archivo CSS echo "body { background: lightblue; }" > style.css # Ver qué cambió git status # Añadir y commit git add style.css git commit -m "Añadir estilos CSS" ``` ### Paso 5: Ver el Historial ```bash $ git log --oneline b4f3a2e (HEAD -> main) Añadir estilos CSS c7d1e9f Commit inicial: añadir README e index.html ``` --- ## 🌿 Trabajar con Ramas ### Crear y Cambiar de Rama ```bash # Crear nueva rama git branch nueva-feature # Cambiar a la rama git checkout nueva-feature # Crear y cambiar en un solo comando git checkout -b otra-feature ``` ### Ver Ramas ```bash $ git branch main * nueva-feature ← Estás aquí otra-feature ``` ### Fusionar Ramas (Merge) ```bash # Volver a main git checkout main # Fusionar nueva-feature en main git merge nueva-feature # Eliminar rama ya fusionada git branch -d nueva-feature ``` --- ## 🌐 GitHub: Git en la Nube ### ¿Qué es GitHub? **GitHub** es una plataforma que aloja repositorios Git en la nube. ``` Tu Computadora (Git local) ↕ Internet ↕ GitHub (Git remoto en la nube) ``` ### Ventajas de GitHub 1. ✅ **Backup automático** de tu código 2. ✅ **Colaboración** con otros desarrolladores 3. ✅ **Portfolio** público de proyectos 4. ✅ **Integración** con herramientas (Claude Code, CI/CD) 5. ✅ **Gratuito** para proyectos públicos y privados ### Conectar con GitHub **1. Crear repositorio en GitHub:** - Ir a github.com - Click en "New repository" - Nombrar el repo - Click "Create repository" **2. Conectar repositorio local:** ```bash # Añadir repositorio remoto git remote add origin https://github.com/tu-usuario/mi-proyecto.git # Verificar git remote -v # Subir código a GitHub git push -u origin main ``` **3. Descargar cambios:** ```bash # Traer cambios de GitHub git pull origin main ``` --- ## 🔄 Flujo de Trabajo Completo ### Escenario Real: Añadir Nueva Feature ```bash # 1. Asegurarte de estar actualizado git pull origin main # 2. Crear rama para nueva feature git checkout -b feature/login # 3. Hacer cambios en el código # (editar archivos) # 4. Ver qué cambió git status git diff # 5. Añadir y commit git add . git commit -m "Implementar formulario de login" # 6. Subir a GitHub git push origin feature/login # 7. En GitHub: crear Pull Request # 8. Después de aprobación: fusionar git checkout main git pull origin main git merge feature/login git push origin main # 9. Eliminar rama ya fusionada git branch -d feature/login git push origin --delete feature/login ``` --- ## 📝 .gitignore: Archivos a Ignorar ### ¿Qué es .gitignore? Un archivo que dice a Git qué archivos NO rastrear. **Crear `.gitignore`:** ```bash # .gitignore # Dependencias node_modules/ vendor/ # Archivos de entorno (secretos) .env .env.local # Archivos de build dist/ build/ *.log # Archivos de sistema .DS_Store Thumbs.db # IDEs .vscode/ .idea/ *.swp ``` ### Por Qué es Importante ``` ❌ NO subir a GitHub: - node_modules/ (muy pesado, se reinstala con npm install) - .env (contiene contraseñas y secretos) - archivos personales de configuración ✅ SÍ subir a GitHub: - Código fuente - README.md - package.json - .gitignore ``` --- ## 🚀 Git con Claude Code ### Por Qué Git es Esencial con Claude Code **1. Claude Code trabaja con repositorios Git:** ```bash $ claude-code # Claude entiende tu historial de Git # Puede ver commits anteriores # Respeta tu .gitignore ``` **2. Claude puede generar commits:** ```bash # Claude te ayuda con mensajes de commit descriptivos git commit -m "feat: Añadir autenticación de usuarios con JWT" ``` **3. Workflow perfecto:** ``` 1. Claude genera código 2. Tú revisas los cambios (git diff) 3. Haces commit si está bien 4. O reviertes si no (git checkout .) ``` --- ## 📊 Comandos Git Esenciales - Cheat Sheet ### Configuración ```bash git config --global user.name "Nombre" git config --global user.email "email@example.com" ``` ### Iniciar/Clonar ```bash git init # Nuevo repo git clone URL # Clonar repo existente ``` ### Básicos ```bash git status # Ver estado git add archivo # Añadir archivo git add . # Añadir todo git commit -m "mensaje" # Hacer commit git log # Ver historial git log --oneline # Historial resumido ``` ### Ramas ```bash git branch # Ver ramas git branch nombre # Crear rama git checkout nombre # Cambiar de rama git checkout -b nombre # Crear y cambiar git merge rama # Fusionar rama git branch -d rama # Eliminar rama ``` ### Remotos (GitHub) ```bash git remote add origin URL # Añadir remoto git push origin main # Subir a GitHub git pull origin main # Descargar de GitHub git clone URL # Clonar repositorio ``` ### Deshacer Cambios ```bash git checkout archivo # Descartar cambios en archivo git checkout . # Descartar todos los cambios git reset HEAD archivo # Quitar de staging git revert commit-hash # Revertir commit ``` --- ## ✅ Ejercicio de Verificación **1. ¿Qué es Git?**

Ver respuesta

Un sistema de control de versiones que guarda el historial de cambios en tu código.

**2. ¿Qué hace el comando `git add`?**

Ver respuesta

Añade archivos al staging area (prepara los cambios para el commit).

**3. ¿Para qué sirve GitHub?**

Ver respuesta

Para alojar repositorios Git en la nube, permitiendo colaboración y backup.

**4. ¿Qué archivo usas para ignorar archivos en Git?**

Ver respuesta

`.gitignore`

--- ## 🎯 Próxima Lección En la siguiente lección aprenderás: **Lección 0.6: "Instalación guiada de herramientas"** - Instalar Node.js paso a paso - Instalar Git en tu sistema - Configurar Visual Studio Code - Instalar Claude Code CLI - Verificar que todo funciona --- ## 📖 Recursos Adicionales ### Documentación Oficial - [Git Documentation](https://git-scm.com/doc) - [GitHub Guides](https://guides.github.com/) ### Aprender Más - [Git Cheat Sheet](https://education.github.com/git-cheat-sheet-education.pdf) - [Visualizar Git](https://git-school.github.io/visualizing-git/) ### Convenciones de Commits ```bash # Formato recomendado tipo: descripción corta # Tipos comunes: feat: Nueva característica fix: Corrección de bug docs: Cambios en documentación style: Formato, punto y coma, etc. refactor: Refactorización de código test: Añadir tests chore: Tareas de mantenimiento # Ejemplos: git commit -m "feat: Añadir login con Google" git commit -m "fix: Corregir error en validación de email" git commit -m "docs: Actualizar README con instrucciones" ``` --- > **Tip Pro:** Git es usado por el 95% de los desarrolladores profesionales. Dominarlo es esencial para trabajar en equipo y gestionar proyectos grandes. ¡Practica estos comandos hasta que se vuelvan segunda naturaleza!