Comment fusionner des branches dans GitHub : guide étape par étape

Fusionner des branches dans GitHub est essentiel lorsque plusieurs personnes (ou même simplement différentes fonctionnalités sur lesquelles vous travaillez) doivent fusionner. Si vous débutez, cela peut parfois sembler un peu compliqué, surtout si des conflits surgissent ou si vous essayez de le faire en ligne de commande et que vous ne savez pas exactement quelles commandes sont importantes. Ce guide vous explique tout, que vous préfériez naviguer sur le site web ou saisir des commandes dans votre terminal. Attendez-vous à pouvoir fusionner les modifications de code en douceur et à garder votre projet propre et net, sans écraser accidentellement le travail d’un autre utilisateur ni vous retrouver dans un enfer de fusion.

Comment fusionner une branche dans GitHub ?

Méthode 1 : Fusion avec le site Web GitHub

C’est souvent la solution la plus simple pour ceux qui ne veulent pas s’embêter avec les commandes du terminal. C’est visuel, simple et compatible avec Reddit. De plus, vous pouvez le faire directement depuis votre navigateur, aucune configuration n’est donc nécessaire.

1. Ouvrez le référentiel sur GitHub où se trouvent vos branches.
2. Cliquez sur l’ onglet Demandes d’extraction en haut de la page du dépôt.
3. Cliquez sur Nouvelle demande d’extraction.
4. Choisissez la branche de base (probablement principale ou master), puis comparez-la à la branche de fonctionnalité que vous souhaitez intégrer (par exemple, feature-xyz).En cas de doute, ces branches sont généralement clairement identifiées.
5. Vérifiez les modifications sur le point d’être fusionnées. Il est parfois judicieux de vérifier à nouveau, surtout si de nombreuses mises à jour ont été publiées récemment.
6. Cliquez sur « Créer une pull request ». Ajoutez un titre rapide et une note expliquant l’effet de cette fusion (car, bien sûr, GitHub vous oblige à le faire).
7. Si tout semble correct, cliquez sur le bouton Fusionner la demande d’extraction.
8. Confirmez la fusion en cliquant sur « Confirmer la fusion ». Et voilà ! Votre branche fait désormais partie de l’entité fusionnée.

Avant ou après cela, de nombreuses personnes clonent le dépôt localement sur leur machine pour travailler directement sur le code, puis le redistribuent lorsqu’elles sont prêtes. C’est probablement plus naturel pour les développeurs sérieux.

Méthode 2 : Fusion via la ligne de commande

C’est là que certains utilisent Git Bash, Terminal ou PowerShell pour effectuer un peu de travail manuel. C’est plus rapide une fois maîtrisé, et c’est parfois la seule solution pour automatiser des tâches ou travailler sur des pipelines CI/CD.

1. Ouvrez votre terminal ou Git Bash.
2. Accédez à votre dossier de dépôt local à l’aide de cd /path/to/your/repo.
3. Assurez-vous que vous êtes sur la branche principale : git checkout main. Si votre branche principale s’appelle master ou autre chose, remplacez-la en conséquence.
4. Extraire les dernières modifications depuis l’origine : git pull origin main.
5. Fusionnez votre branche de fonctionnalités : git merge feature-branch. Remplacez-la feature-branchpar le nom de votre branche.
6. S’il n’y a pas de conflits, vous pouvez renvoyer le code combiné : git push origin main.

En cas de conflit, vous devrez ouvrir ces fichiers, déterminer les lignes à conserver, puis exécuter la commande git addsur les fichiers résolus et git commitfinaliser la fusion. Les conflits sont gênants, mais gérables ; parfois, une simple modification manuelle suffit. Fait amusant : dans certaines configurations, des conflits apparaissent même s’ils ne devraient pas, ce qui est… étrange, mais une réinitialisation ou un rebasage peut aider.

Gestion des conflits de fusion

Des conflits surviennent lorsque deux branches modifient les mêmes lignes de code. Si Git ne sait pas laquelle conserver, il marquera ces sections, et vous devrez choisir.

1. Git signalera les fichiers en conflit après votre tentative de fusion. Il vous indiquera généralement les fichiers à corriger.
2. Ouvrez ces fichiers dans votre éditeur de code. Faites attention aux sections marquées par <<<<<<<, ======= et >>>>>>>>.Git vous indique ainsi où se situent les conflits.
3. Décidez des modifications à conserver, supprimez les marqueurs de conflit et enregistrez.
4. Exécutez git add.pour mettre en scène les fichiers résolus.
5. Terminez avec git commit— pendant cet engagement, vous pouvez même ajouter un message sur la résolution des conflits.
6. Envoyez vos modifications à distance : git push origin main.

Ce processus peut être frustrant les premières fois, surtout si des conflits surviennent de manière inattendue ou lors de fusions complexes. Mais après quelques tentatives, cela devient moins pénible et vous commencez à repérer les conflits plus tôt.

Pourquoi la fusion est importante

En résumé, la fusion assure la synchronisation de tout le travail. Elle garantit que tout le monde travaille sur le code le plus récent, évite les doublons et évite de se retrouver avec un fouillis de versions différentes.

FAQ