Guía Avanzada de Git: Domina el historial, depuración y flujos complejos

Tabla de contenido

Si ya dominas los comandos básicos (add, commit, push, pull), es hora de desbloquear el verdadero poder de Git. Esta guía está diseñada para resolver escenarios complejos, auditar código y salvar proyectos de catástrofes.

1. Commits Quirúrgicos (Staging Parcial) #

A veces modificas muchas cosas en un mismo archivo, pero quieres separarlas en distintos commits para mantener un historial atómico y limpio.

💡 Tip: En los modos interactivos, Git suele abrir tu editor de texto por defecto (frecuentemente Vim). Para guardar y salir en Vim, presiona Esc y escribe :wq seguido de Enter.

Comando	Descripción
`git add -p <archivo>`	(Patch) Inicia un modo interactivo que te pregunta fragmento por fragmento (hunk) si deseas agregarlo al staging.
`git commit --amend --no-edit`	Agrega los cambios actuales en staging al último commit existente sin abrir el editor para cambiar el mensaje.
`git stash push -m "msg"`	Crea un stash con un mensaje personalizado para identificarlo fácilmente en el futuro.
`git stash -u`	Guarda temporalmente tus cambios, incluyendo los archivos nuevos que Git aún no está rastreando (untracked).

2. Reescritura del Historial (Rebase Avanzado) #

El rebase no solo sirve para actualizar ramas; es la herramienta definitiva para “maquillar” tu historial antes de subirlo al repositorio remoto.

Regla de Oro del Rebase
Peligro: Nunca hagas rebase de commits que ya has subido a un repositorio público y que otras personas están usando. Reescribir la historia pública causa conflictos masivos.

Comando	Descripción
`git rebase -i <commit>`	Abre el historial desde el commit indicado para reordenar, fusionar (squash), editar o eliminar commits específicos.
`git cherry-pick <commit>`	Toma un commit específico de cualquier rama y lo aplica como un nuevo commit en tu rama actual¹.
`git rebase --onto <nueva-base> <vieja-base> <rama>`	Mueve una rama (o un segmento de commits) de una rama padre a otra totalmente distinta.
`git pull --rebase`	Descarga los cambios del remoto y aplica tus commits locales por encima de ellos, evitando el commit automático de merge.

3. Depuración y Auditoría de Código #

Cuando aparece un bug y nadie sabe cuándo se introdujo, estos comandos te ahorrarán horas de lectura manual de código.

Comando	Descripción
`git blame <archivo>`	Muestra línea por línea quién fue la última persona en modificar cada fragmento de un archivo y en qué commit lo hizo.
`git grep "texto"`	Busca una cadena de texto o expresión regular en todo tu código fuente rastreado de forma extremadamente rápida.
`git bisect start`	Inicia un asistente de búsqueda binaria para encontrar exactamente qué commit introdujo un bug².
`git bisect good <commit>`	Le indica a `bisect` un punto en la historia donde sabes que el código funcionaba bien.
`git bisect bad <commit>`	Le indica a `bisect` el commit actual (o pasado) donde el error ya está presente.

4. Espacios de Trabajo Paralelos (Worktrees) #

git worktree es un superpoder que poca gente conoce. Te permite tener múltiples ramas abiertas simultáneamente en diferentes carpetas de tu computadora, usando el mismo repositorio local.

Comando	Descripción
`git worktree add <ruta> <rama>`	Crea una nueva carpeta en tu sistema vinculada al repositorio, haciendo checkout a la rama especificada.
`git worktree list`	Muestra todos los directorios de trabajo paralelos que tienes activos.
`git worktree remove <ruta>`	Elimina de forma segura un directorio de trabajo paralelo.

5. Mantenimiento y Rescate Extremo #

Si borraste una rama por error, hiciste un reset --hard desastroso o Git parece estar fallando, este es tu botiquín de primeros auxilios.

Comando	Descripción
`git reflog`	El registro absoluto. Muestra todos los movimientos de HEAD, incluso los cambios descartados por un `reset` o ramas borradas.
`git fsck`	(File System Check) Verifica la integridad de la base de datos interna de Git y busca objetos corruptos o perdidos.
`git gc`	(Garbage Collector) Limpia archivos innecesarios y optimiza el repositorio local, reduciendo su tamaño en disco.

6. Atajos Personalizados (Alias) #

Si te cansas de escribir comandos largos, Git te permite crear tus propios atajos modificando tu archivo .gitconfig.

Comando	Descripción
`git config --global alias.st status`	Crea el atajo `git st` para ver rápidamente el estado de tus archivos.
`git config --global alias.co switch`	Crea el atajo `git co` para cambiar de ramas rápidamente.
`git config --global alias.lg "log --oneline --graph --decorate"`	(Muy recomendado) Crea el comando `git lg` para renderizar el historial como un árbol visual compacto y fácil de leer.

Notas y Referencias #

El comando cherry-pick es ideal cuando arreglas un bug en la rama de desarrollo (develop) y necesitas llevar esa corrección exacta a la rama de producción (main) sin fusionar el resto de características inacabadas. ↩︎
¿Cómo funciona git bisect? Utiliza un algoritmo de búsqueda binaria. Tú le das un commit “bueno” y uno “malo”. Git salta justo a la mitad del historial entre ambos puntos. Pruebas tu código y le dices a Git si ese punto es bueno (git bisect good) o malo (git bisect bad). Git seguirá partiendo el historial por la mitad hasta aislar el commit exacto que rompió la aplicación. Para terminar, usa git bisect reset. ↩︎