Git y GitHub

Del historial en tu carpeta al remoto en la nube: instalar, Git GUI, commits, ramas, pull requests y cómo salir de un conflicto sin romper el proyecto.

Desde cero Git GUI Terminal Práctica

Descargar .tex Descargar .md

Cuando dos cambios chocan

Git fusiona bien la mayor parte del trabajo en paralelo: si tocáis archivos distintos, o zonas distintas del mismo archivo, el merge suele resolverse solo. El problema aparece cuando dos personas (o tú mismo en dos clones) modificáis las mismas líneas. Entonces Git no puede adivinar qué versión es la correcta: detiene el merge, marca el conflicto en el archivo y te pide que elijas.

Eso también ocurre si haces pull sobre trabajo local que aún no has subido y el remoto cambió las mismas líneas.

Cómo se ve en el archivo

Git inserta marcadores especiales. No son código de tu programa: son avisos que debes borrar antes de terminar:

<<<<<<< HEAD
<h1>Título mío</h1>
=======
<h1>Título del compañero</h1>
>>>>>>> feature-login

`<<<<<<< HEAD`

Empieza tu versión (la de la rama en la que estás ahora).

`=======`

Separador. Debajo viene lo que llega de la otra rama o del remoto.

`>>>>>>> …`

Cierra el bloque. El nombre indica de dónde viene el otro cambio.

Abres el archivo, dejas solo el código bueno (o una mezcla sensata), borras los tres marcadores y guardas. Si dejas un <<< dentro, la página o el programa se romperá al ejecutarse.

En Git GUI

Tras un Pull o Merge fallido, el archivo conflictivo aparece en Unstaged (a veces con un estado especial).
Ábrelo en el editor, limpia los marcadores y comprueba que el proyecto sigue funcionando.
Rescan → stagea ese archivo → Commit con un mensaje claro («Resolver conflicto en index.html»).
Si el objetivo era sincronizar con el remoto, termina con Push.

En Cursor o VS Code suele haber botones del tipo «Accept Current / Incoming / Both». Hacen lo mismo: eliges el texto final y luego haces el commit de resolución.

gitk: ver el historial con claridad

Cuando el grafo se complica, ayuda verlo dibujado. Desde Git GUI: Repository → Visualize All Branch History; o en la terminal, gitk. Verás commits, ramas y autores. Sirve para responder «¿cuándo se rompió esto?» sin adivinar.

Clic en un commit → Diff a la derecha.
Las líneas que se bifurcan son ramas.
Si un merge te confunde, mira gitk antes de tocar más código.

Precaución: no hagas git add . y un commit «merge» sin abrir los archivos en conflicto. Es la forma más rápida de dejar marcadores <<< dentro del proyecto.