Comment résoudre les conflits sur GitHub en toute transparence

Les conflits sur GitHub sont ces moments pénibles où plusieurs modifications entrent en conflit et où Git ne sait plus à qui faire confiance. Sans résolution, la fusion de vos branches est impossible, ce qui est pénible, surtout si vous avez une échéance à respecter. Ce guide rapide explique comment résoudre correctement les conflits, que vous préfériez le terminal, l’interface web ou votre IDE préféré. Comprendre comment gérer les conflits peut vous éviter bien des soucis et accélérer la fusion de votre code, même en cas de confusion.

Comment résoudre les conflits dans GitHub

Méthode 1 : Utilisation du terminal (ligne de commande)

C’est la méthode la plus complète : vous avez un contrôle total sur ce qui est fusionné. Idéal si les conflits sont complexes ou si vous souhaitez choisir soigneusement ce qui reste. Son utilité ? Parce que vous voyez, modifiez et décidez réellement de ce qui est quoi. En cas de conflit, votre code est signalé lors de la fusion, et c’est là que cette méthode prend tout son sens. Attendez-vous à obtenir une branche propre, sans conflit, prête à être déployée.

1. Commencez par exécutergit fetch origin : cela met à jour votre copie locale avec les modifications présentes sur GitHub sans modifier vos modifications actuelles. Des conflits peuvent survenir lorsque votre branche locale est en retard.
2. Accédez à votre branche fonctionnelle : git checkout branch-name. Remplacez branch-namepar le nom de votre branche. En cas de doute, saisissez le nom git branchpour voir ce qui est actif.
3. Ensuite, fusionnez les dernières modifications de la branche cible (généralement mainou developavec git merge mainla branche de votre choix).Cela générera des conflits s’ils existent.
4. Si Git signale des conflits, ouvrez les fichiers concernés. Vous verrez des marqueurs tels que <<<<<<<, ======= et >>>>>>>>.Ce n’est pas très pratique, mais c’est la seule façon de les résoudre.
5. Choisissez le code à conserver : conservez les modifications actuelles, les modifications à venir ou combinez-les. Supprimez les marqueurs de conflit après modification. C’est un peu étrange, mais il faut vraiment être prudent.
6. Enregistrez votre fichier, puis effectuez-le avec git add filename. Répétez l’opération pour tous les fichiers en conflit.
7. Une fois tous les conflits résolus et mis en scène, validez avec git commit. Git peut renseigner automatiquement le message, mais vérifiez bien qu’il est cohérent.
8. Enfin, remettez votre branche sur GitHub avec git push origin branch-name. C’est fait.

Cette méthode est très utile car elle permet de localiser précisément les conflits et de décider comment les résoudre. Dans certaines configurations, les conflits peuvent être tenaces au début et nécessiter git fetchune nouvelle exécution ou un redémarrage du terminal.

Méthode 2 : Résoudre les conflits via GitHub Web ou IDE

Si la ligne de commande n’est pas votre fort ou si les conflits sont mineurs, voici une solution simple et rapide. Ouvrez simplement votre pull request sur GitHub, cliquez sur « Résoudre les conflits » et un éditeur intégré vous permettra de corriger les erreurs. Pour ceux qui utilisent VS Code ou un autre IDE, les conflits seront mis en évidence directement dans l’éditeur, avec des boutons permettant d’accepter les modifications entrantes ou actuelles. En général, c’est la solution idéale pour les conflits simples et mineurs, mais attention, vous risquez de passer à côté de problèmes plus profonds ou d’un contexte que seul le terminal révèle.

1. Accédez à votre page de demande d’extraction sur GitHub.
2. Cliquez sur le bouton Résoudre les conflits : il apparaît généralement lorsque GitHub détecte des conflits lors de l’examen des relations publiques.
3. Utilisez l’éditeur qui apparaît pour sélectionner les modifications à conserver ou les modifier manuellement si nécessaire. Enregistrez vos modifications.
4. Validez la fusion directement dans GitHub une fois tous les conflits résolus.
5. Si vous travaillez dans VS Code, ouvrez le fichier en conflit, qui sera marqué par <<<<<<<, ======= et >>>>>>>>.Vous pouvez choisir des options comme Accepter les modifications actuelles ou Accepter les modifications entrantes parmi celles situées au-dessus des conflits. Enregistrez et stockez ces fichiers.

C’est pratique lorsque les conflits sont simples ou que des solutions rapides sont nécessaires sans changer d’outil. Une autre option à essayer si vous avez peur de vous tromper avec la CLI.

Conseils pour éviter les conflits à l’avenir

• Effectuez des extractions depuis la branche principale ou votre branche principale assez souvent pour maintenir votre branche locale à jour. Pourquoi ? Plus votre branche reste inactive longtemps, plus les risques de conflits lors de la fusion sont élevés.
• Discutez avec vos coéquipiers si vous travaillez sur les mêmes fichiers : il est préférable de se coordonner plutôt que de se surprendre.
• Privilégiez la courte durée de vie des branches de fonctionnalités. Plus elles restent en place, plus elles divergent, ce qui peut engendrer des conflits plus importants lors de leur fusion.
• Utilisez les demandes d’extraction et les révisions de code pour détecter rapidement les chevauchements de travail et éviter que les conflits ne deviennent des problèmes plus importants par la suite.

Pourquoi les conflits surviennent-ils ?

• Lorsque deux branches modifient la même ligne de code ou section, Git ne sait plus quelle modification conserver.
• Les fichiers sont supprimés dans une branche mais modifiés dans une autre, ce qui entraîne des conflits de chevauchement.
• Les branches divergent au fil du temps avec différentes modifications, donc la fusion entraîne des conflits.

En résumé : vous devez examiner manuellement ces conflits et choisir le bon code, ce qui est parfois fastidieux mais inévitable.

FAQ