Guía Básica de Git

1. 💡 Introducción a Git

Git es un sistema de control de versiones distribuido que permite gestionar y controlar los cambios en tu código fuente a lo largo del tiempo.

Esencial para equipos, colaboración y control de versiones en proyectos de software.

---

2. ⚙️ Comandos Básicos

Acción	Comando
Inicializar repo	git init
Ver estado	git status
Agregar archivos	git add .
Hacer commit	git commit -m "mensaje"
Ver historial	git log --oneline
Ver ramas	git branch
Crear nueva rama	git checkout -b nueva-rama
Cambiar de rama	git switch nombre-rama
Subir cambios	git push -u origin rama
Traer cambios del remoto	git pull
Agregar repositorio remoto	git remote add origin URL
Ver remotos	git remote -v

---

3. 🔄 Flujo de trabajo recomendado

1. Clona o inicia tu repo local.

2. Crea una nueva rama: git checkout -b feature/nueva-funcion.

3. Realiza cambios, prueba, guarda.

4. Haz commits claros y significativos.

5. Sube tu rama: git push -u origin feature/nueva-funcion.

6. Abre un Pull Request en GitHub.

7. Solicita revisión o haz merge.

---

4. 🌿 Manejo de Ramas

• main: rama principal estable.

• feature/nombre: nuevas funcionalidades.

• fix/nombre: correcciones de errores.

• hotfix/nombre: correcciones urgentes sobre producción.

---

5. ✅ Buenas Prácticas de Commits

• Haz commits pequeños y enfocados.

• Usa mensajes descriptivos.

• Relaciona el commit con una tarea, issue o módulo.

• Evita commits genéricos como "arreglos" o "cambios varios".

---

6. 🧠 Formato Profesional para Commits (Conventional Commits)

<tipo>(módulo): descripción corta del cambio

Tipos más comunes:

Tipo	Uso
feat	Nueva funcionalidad
fix	Corrección de error
docs	Cambios en documentación
style	Formato, espacios, sin afectar lógica
refactor	Cambios internos sin alterar funcionalidades
test	Agregar o modificar pruebas
chore	Tareas menores o mantenimiento

Ejemplos:

git commit -m "feat(auth): agrega validación de correo"
git commit -m "fix(api): corrige error 500 en login"
git commit -m "docs(readme): agrega pasos de instalación"

---

7. 🛠️ Comandos útiles extra

• Ver diferencias antes del commit:

  git diff
  git diff --cached

• Revertir commit:

  git revert <hash>

• Borrar archivos del staging:

  git reset archivo.js

• Forzar sincronización con remoto:

  git fetch origin
  git reset --hard origin/main

---

8. 📚 Recursos adicionales

• Guía oficial de Git

• Conventional Commits

• GitHub Docs