Resolución manual de conflictos de merge

¡Le damos la bienvenida al mundo de los conflictos de fusión! No se preocupe: son una parte normal de la colaboración con Git. Un conflicto de fusión ocurre cuando Git no puede determinar automáticamente cómo combinar los cambios de dos ramas diferentes.

Esto suele ocurrir cuando dos ramas modifican las mismas líneas del mismo archivo de maneras diferentes, o cuando una rama elimina un archivo que otra rama ha modificado.

Git es increíblemente eficaz al fusionar la mayoría de los cambios de forma automática. Sin embargo, necesita ayuda humana cuando se enfrenta a una situación ambigua. Estos son algunos casos habituales:

• La misma línea, cambios diferentes: dos personas editan de forma distinta exactamente la misma línea de código.
• Una rama elimina y otra modifica: una rama elimina un archivo mientras otra lo modifica.
• Renombrar frente a modificar: un archivo se renombra en una rama y se modifica en otra.

Cuando se produce un conflicto de fusión, Git no completará la fusión automáticamente. En su lugar, pausará el proceso y le indicará qué archivos tienen conflictos. Verá un mensaje similar a este:

Después de que falle una fusión automática, su repositorio se encontrará en estado de «fusión». Puede utilizar git status para ver qué archivos tienen conflictos. Estos archivos aparecerán en la lista como «rutas sin fusionar».

Git inserta marcadores especiales directamente en los archivos en conflicto para mostrar dónde está el problema. Estos marcadores le ayudan a identificar las diferentes versiones del código:

• <<<<<<< HEAD: marca el inicio de los cambios de su rama actual.
• =======: separa los cambios de las dos ramas.
• >>>>>>> branch-name: marca el final de los cambios de la rama entrante.

Veamos un ejemplo. Imagine que tiene un archivo hello.txt. Su rama main lo cambió a «Hello from main», y una rama feature cambió la misma línea a «Greetings from feature». Al fusionar feature con main, el archivo tendrá este aspecto:

Su tarea consiste en abrir el archivo en conflicto (por ejemplo, hello.txt) en su editor de texto. Después, debe editar manualmente el archivo para eliminar los marcadores de conflicto y elegir el contenido deseado. Puede combinar partes, escoger una de las versiones o escribir algo completamente nuevo.

En nuestro ejemplo de hello.txt, si quisiéramos conservar ambos mensajes, podríamos editarlo así:

Una vez que haya editado manualmente el archivo y eliminado todos los marcadores de conflicto, debe indicar a Git que ha resuelto el conflicto. Para ello, prepare el archivo con git add.

Repita este proceso con cada archivo que git status muestre como «ruta sin fusionar».

Una vez preparados todos los archivos en conflicto, la fusión está lista para confirmarse. Normalmente, Git proporcionará un mensaje de confirmación de fusión predeterminado, que puede aceptar o modificar. Esta confirmación final completa el proceso de fusión.

Ha resuelto correctamente un conflicto de fusión. Ahora, comprobemos si comprende el siguiente paso fundamental después de editar manualmente un archivo en conflicto.

¡Ha aprendido a resolver conflictos de fusión manualmente! Es una habilidad fundamental para cualquier desarrollador.

• Los conflictos ocurren cuando Git no puede fusionar los cambios automáticamente.
• git status muestra los archivos sin fusionar.
• Los marcadores de conflicto (<<<<<<<, =======, >>>>>>>) muestran el código divergente.
• Edite los archivos manualmente, elimine los marcadores y elija el contenido final.
• Prepare los archivos resueltos con git add.
• Complete la fusión con git commit.

¡La práctica hace al maestro! Los conflictos pueden parecer intimidantes al principio, pero con estos pasos logrará dominarlos.