khalilbenaz Git Workflow Helper
1. Diagnostic initial
Avant toute action, évaluer la situation :
git status # état de l'index et du working tree
git log --oneline --graph -15 # historique visuel récent
git stash list # stashs en attente
git remote -v # remotes configurées
Identifier : branche courante, commits non-pushés, fichiers modifiés/stagés, conflits actifs.
2. Résolution de conflits de merge
Étapes :
- Lancer le merge ou rebase, observer les conflits :
git merge feature/ma-branche # ou git rebase main - Lister les fichiers en conflit :
git diff --name-only --diff-filter=U - Éditer chaque fichier : supprimer les marqueurs
<<<<<<<,=======,>>>>>>>, garder le bon code. - Marquer comme résolu et continuer :
git add <fichier-résolu> git merge --continue # ou git rebase --continue - En cas d'impasse, annuler proprement :
git merge --abort # ou git rebase --abort
Outil visuel (recommandé) :
git mergetool # ouvre vimdiff, VS Code, IntelliJ selon config
3. Annuler / corriger des commits
| Situation | Commande | Risque |
|---|---|---|
| Défaire le dernier commit (garder les modifs) | git reset --soft HEAD~1 |
Faible |
| Défaire le dernier commit (perdre les modifs) | git reset --hard HEAD~1 |
Destructif |
| Corriger le message du dernier commit | git commit --amend --no-edit |
Faible si pas pushé |
| Annuler un commit déjà pushé (safe) | git revert <sha> |
Nul — crée un commit inverse |
| Supprimer un commit du milieu de l'historique | git rebase -i HEAD~N |
Modéré |
Règle d'or : ne jamais --force-push sur main/master. Sur une branche feature partagée, prévenir l'équipe.
4. Rebase interactif — recette type
git fetch origin
git rebase -i origin/main
Dans l'éditeur, remplacer pick par :
squash(s) — fusionner dans le commit précédentreword(r) — changer le messagedrop(d) — supprimer le commitfixup(f) — squash sans garder le message
Après résolution des conflits éventuels :
git rebase --continue
git push --force-with-lease # plus sûr que --force : échoue si la remote a bougé
5. Stratégies de branches — critères de décision
| Stratégie | Quand l'adopter | Branches clés |
|---|---|---|
| Trunk-based | CI/CD mature, feature flags, équipe senior | main + branches courtes (<1 jour) |
| GitHub Flow | SaaS, déploiement continu, équipe ≤15 | main + feature/* + PR |
| Git Flow | Releases versionnées, mobile/desktop, hotfixes fréquents | main, develop, release/*, hotfix/*, feature/* |
Convention de nommage recommandée :
feature/<ticket-id>-description-courte
fix/<ticket-id>-description
chore/update-dependencies
hotfix/v2.3.1-crash-login
6. Convention de commit (Conventional Commits)
<type>(<scope>): <description courte>
[corps optionnel]
[footer: BREAKING CHANGE: ... ou Closes #123]
Types courants : feat, fix, chore, docs, refactor, test, perf, ci
Exemple :
feat(auth): ajouter le login biométrique iOS
Implémente Face ID et Touch ID via LocalAuthentication.
Désactive le fallback PIN si biométrie disponible.
Closes #489
7. Sauvegarder avant une opération risquée
# Créer une branche de sauvegarde avant toute manipulation dangereuse
git branch backup/$(git rev-parse --abbrev-ref HEAD)-$(date +%Y%m%d)
# Stasher les modifs non-commitées
git stash push -m "backup avant rebase 2026-06-24"
8. Garde-fous et anti-patterns
Ne jamais faire :
git push --forcesur une branche partagée sans--force-with-leasegit reset --hardsans avoir vérifiégit stashou créé une branche backup- Commiter des secrets (
.env, clés API) — utilisergit-secretou.gitignorestrict - Laisser des merge commits de merge de merge (rebase avant de merger)
- Branches vivant > 2 semaines sans merge : risque de divergence majeure
Pièges fréquents :
git pullsans--rebasecrée des merge commits parasites → configurer globalement :git config --global pull.rebase true- Oublier
git fetchavant un rebase : on rebase sur une base obsolète git stash popsur le mauvais contexte : toujours vérifiergit stash listavant- Fichiers binaires en conflit : privilégier
git checkout --ours <fichier>ou--theirs
9. Configuration globale utile (2026)
# Affichage lisible
git config --global log.date relative
git config --global alias.lg "log --oneline --graph --decorate --all"
# Sécurité
git config --global push.default current
git config --global pull.rebase true
git config --global rerere.enabled true # mémorise les résolutions de conflits
# Signer les commits (recommandé en équipe)
git config --global commit.gpgsign true
10. Récupérer après une catastrophe
# Retrouver un commit "perdu" après reset --hard
git reflog
git checkout <sha-perdu> # inspecter
git branch recovery/ma-branche <sha-perdu> # restaurer
# Retrouver un fichier supprimé
git log --all --full-history -- chemin/fichier.txt
git checkout <sha>^ -- chemin/fichier.txt
git reflog conserve l'historique local des mouvements HEAD pendant ~90 jours.