Git — Workflows avancés

# Créer une feature courte
git switch -c feat/ma-fonctionnalité main
 
# Travailler, commiter souvent
# Pousser chaque soir ou en fin de journée
 
# Ouvrir une PR depuis la branche feature
# Après review et merge, suppression de la branche
git push origin feat/ma-fonctionnalité

# Workflow typique
git switch -c feat/mon-changement main
# ... développement ...
git push origin feat/mon-changement
# → Ouvrir un Pull Request sur GitHub/GitLab
# → Review, CI passe, merge
git switch main && git pull

main ─────────────── main (tagué)
  │                    ▲
  │  release/*         │  hotfix/*
  │  develop           │  develop
  │   ▲                │   ▲
  │   │ feature/*      │   │ feature/*
  │   └────────────────┘   └─────────────────

# Initialisation
git checkout -b develop origin/main
 
# Feature
git checkout -b feature/nom develop
# ... travail ...
git checkout develop
git merge --no-ff feature/nom
 
# Release
git checkout -b release/1.2.0 develop
# corrections mineures uniquement
git checkout main
git merge --no-ff release/1.2.0
git tag -a v1.2.0
git checkout develop
git merge --no-ff release/1.2.0
 
# Hotfix
git checkout -b hotfix/1.2.1 main
# correction critique
git checkout main
git merge --no-ff hotfix/1.2.1
git tag -a v1.2.1
git checkout develop
git merge --no-ff hotfix/1.2.1

# Voir l'historique des mouvements de HEAD
git reflog
 
# Retrouver un commit "perdu" après un reset --hard
git reflog
# Exemple de sortie :
# abc1234 HEAD@{2}: reset: moving to HEAD~1
# def5678 HEAD@{3}: commit: fix bug critique
 
# Restaurer
git reset --hard def5678

# Cas : on a supprimé une branche
git branch -D ma-feature      # erreur de manipulation
git reflog | grep ma-feature  # trouver le dernier commit
git branch ma-feature abc1234  # recréer la branche

# Cas : checkout d'un ancien commit (detached HEAD récupérable)
git reflog                    # identifier le commit voulu
git switch -c sauvegarde abc1234

# Entrer en detached HEAD
git switch abc1234            # ancien commit
# HEAD détaché, à abc1234
 
# Explorer l'historique d'un commit spécifique
git switch --detach HEAD~5
 
# Créer une branche depuis ce commit (pas recommandé)
git switch -c temp abc1234

# Sécurisé : créer une branche avant de vérifier un commit
git switch -c debug-old-commits abc1234

# Créer un nouveau worktree à partir de main
git worktree add ../mon-projet-correction -b fix/correction-critique
 
# Lister tous les worktrees actifs
git worktree list
 
# Résultat attendu :
# /home/user/mon-projet    abc1234 HEAD -> main
# /home/user/mon-projet-correction def5678 HEAD -> fix/correction-critique
 
# Travailler dans le nouveau dossier
cd ../mon-projet-correction
# ... développement du hotfix ...
git commit -m "fix: corriger le bug critique"
git push origin fix/correction-critique
 
# Nettoyage : supprimer le worktree quand la branche est mergée
git worktree remove ../mon-projet-correction

# Nettoyer les worktrees orphelins (dossier supprimé manuellement)
git worktree prune

# ❌ DANGEREUX : écrase ce que les autres ont poussé
git push --force origin ma-feature
 
# ✅ SÛR : refuse si quelqu'un d'autre a poussé entre-temps
git push --force-with-lease origin ma-feature
 
# Vérifier avant un force push nécessaire
git fetch origin
git log --oneline origin/ma-feature ^ma-feature
# Si des commits apparaissent ici, les récupérer d'abord
git cherry-pick abc1234

type(scope): description courte

Description longue si nécessaire.
Motivations, contexte, références de tickets.

# .git/hooks/prepare-commit-msg
#!/bin/sh
COMMIT_MSG_FILE=$1
COMMIT_SOURCE=$2
 
# Ajouter automatiquement le numéro de branche dans le message
BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null)
if [ -n "$BRANCH" ] && [ "$COMMIT_SOURCE" != "merge" ]; then
  TICKET=$(echo "$BRANCH" | grep -oP '(?<=/)[A-Z]+-[0-9]+')
  if [ -n "$TICKET" ]; then
    MSG=$(cat "$COMMIT_MSG_FILE")
    echo "$MSG" | head -1 | grep -q "$TICKET" || echo "" >> "$COMMIT_MSG_FILE"
    echo "Réf: $TICKET" >> "$COMMIT_MSG_FILE"
  fi
fi

chmod +x .git/hooks/prepare-commit-msg

# Stasher uniquement les modifications non-stagées
# Les fichiers déjà en stage restent dans l'index
git stash push --keep-index
 
# Utile quand on veut stasher le travail "en vrac"
# sans perdre les fichiers prêts à committer

# Stasher en ne prenant que certains fichiers
git stash push -- fichier1.txt fichier2.txt
 
# Stasher tous les changements, fichiers trackés + non-trackés + ignorés
git stash push -a

# Si le stash crée des conflits avec la branche actuelle
git stash apply   # échoue silencieusement, les conflits sont dans la workspace
 
# Voir ce qui a conflit
git diff --name-only --diff-filter=U
 
# Résoudre, puis valider le stash
git add fichiers_resolus
git stash drop

git checkout release/1.2.x
git cherry-pick abc1234    # le commit de fix sur develop

git reset HEAD~1            # annuler le commit (chaud dans le working dir)
git add -p fichier.txt      # sélectionner les hunks du fix
git commit -m "fix: corriger le bug X"
git add -p fichier.txt      # sélectionner les hunks de la feature
git commit -m "feat: ajouter la fonctionnalité Y"

# ❌ Le merge-base change : le cherry-pick inclut des changements inattendus
git cherry-pick abc1234     # abc1234 a été modifié depuis (rebased)
 
# ✅ Vérifier avant d'appliquer
git show abc1234 --stat
git diff HEAD abc1234       # voir exactement ce qui va être appliqué
 
# Multi-commit cherry-pick : attention à l'ordre
git cherry-pick abc1234 def5678 ghi9012  # dans cet ordre

# Comprendre pourquoi un fichier a changé
git diff HEAD~3 -- fichier.txt
 
# Trouver quand une ligne a été ajoutée
git log -L :ma_fonction:fichier.py
 
# Analyser le graphe des branches locales
git log --oneline --graph --all --decorate -20
 
# Vérifier l'intégrité du repo
git fsck --full
 
# Statistiques de contribution
git shortlog -sn --all