Mémo Git · Intégrer
Lier une issue à une pull request
#12 · Closes #12 (dans la description)
Écrire #12 dans la description d'une pull request (GitHub) ou d'une merge request (GitLab) crée un lien vers l'issue n° 12. Écrire Closes #12 fait en plus fermer l'issue automatiquement quand la pull request est mergée dans la branche par défaut.
Ce que ça fait
#12 dans la description crée un lien vers l'issue ; « Closes #12 » la ferme en plus au merge, sur GitHub comme sur GitLab.
Un cas d'usage
Ta branche corrige le bug signalé dans l'issue #12 et tu veux qu'elle se ferme toute seule une fois la correction mergée.
En ligne de commande
gh pr create --body "Closes #12"- GitHub CLI : crée la pull request avec le mot-clé de fermeture.
glab mr create --description "Closes #12"- GitLab CLI : même chose pour une merge request.
gh pr edit <numéro> --body "…"- Modifie la description d'une pull request existante.
git commit -m "Corrige la connexion (fixes #12)"- Le mot-clé fonctionne aussi dans un message de commit, une fois le commit arrivé dans la branche par défaut.
Dans Merathon
- Dans le formulaire de création, tape « # » dans la description : les issues ouvertes du projet s'affichent, filtrées par numéro ou par mot du titre (les autres, même fermées, sont cherchées sur la forge).
- Entrée insère #12 ; Maj + Entrée insère « Closes #12 ».
- Si le nom de la branche contient le numéro (feat/12-…, fix/issue-12), un bandeau propose « Fermer au merge ».
Questions fréquentes
Quels mots-clés ferment une issue ?
Sur GitHub comme sur GitLab : close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved, suivis du numéro. La casse ne compte pas.
Pourquoi mon issue ne s'est pas fermée ?
Le mot-clé n'agit que lorsque la pull request est mergée dans la branche par défaut du dépôt (souvent main). Un merge vers une autre branche laisse l'issue ouverte.
Comment fermer plusieurs issues ?
Répète le mot-clé pour chacune : Closes #12, closes #15.