Le Cycle de Vie d'un Commit

SlidesPDF PPTX

Niveau : Beginner

Durée : 1h30

Prérequis

Avoir initialisé un dépôt (Atelier 03)
Avoir configuré user.name et user.email (Atelier 02)
Savoir créer et éditer des fichiers

Objectifs d'apprentissage

Expliquer les trois zones de Git (Working Directory, Staging Area, Local Repository)
Utiliser git add, git diff, git commit et leurs variantes
Lire l'historique avec git log, git show et les options --oneline --graph
Rédiger des messages Conventional Commits et éviter les secrets dans l'historique

Progression dans cet atelier0%

Les trois zones de Git — le cœur du modèle

Git ne sauvegarde pas directement vos fichiers. Il les fait passer par 3 zones :

Working Directory — vos fichiers réels sur disque (VS Code, etc.).
Staging Area (index) — zone de préparation : vous choisissez exactement ce qui part.
Local Repository (.git) — base où les commits (snapshots) sont stockés.

Working Directory

Espace de travail local

README.md

Staging Area

Zone d’index temporaire

README.md

Local Repository

Base de données (.git)

Commit (C1)

git add

git commit

Voir les changements : `git status` & `git diff`

Avant d’ajouter, regardez :

git status
git diff

git status
# On branch main
# Changes not staged for commit:
#   modified:   README.md
# Untracked files:
#   app.js

git status --short
#  M README.md
# ?? app.js

git status -u
git status --ignored

git diff
# diff Working Directory vs Staging Area (non stagé)

git diff --staged
# ou --cached — Staging Area vs dernier commit

git diff HEAD
# Working + Staging vs dernier commit

git diff --stat
# résumé chiffré

git diff = quoi ?

diff sans option = non stagé. diff --staged = stagé prêt à committer.

Quand l'utiliser ?

Toujours avant git add et avant git commit pour relire.

Commandes à exécuter

bash

# Cliquez sur les commandes à gauche pour les exécuter dans le simulateur

hashcode-academy:~$_

Préparer : `git add` et ses variantes

Les formes essentielles

Commande	Effet
`git add README.md`	Ajoute un fichier
`git add .`	Ajoute tout le dossier courant (récursif)
`git add -A`	Ajoute tout le dépôt (même hors dossier courant)
`git add -p`	Patch — choisissez morceau par morceau (`y/n`)
`git add -u`	Ajoute les suivis modifiés/supprimés (pas les nouveaux)

Retirer de l’index

git rm --cached README.md   # retire de l'index → redevient Untracked (fichier gardé)
git restore --staged README.md  # unstage les modifications (le fichier reste suivi)
git mv old.js new.js        # renommage suivi

Commandes à exécuter

bash

# Cliquez sur les commandes à gauche pour les exécuter dans le simulateur

hashcode-academy:~$_

Enregistrer : `git commit`

Commit simple

git commit -m "feat: add login page"

Avec éditeur (message multi-lignes)

git commit
# → ouvre $EDITOR (VS Code, vim, nano)
# Ligne 1 : titre (50 chars)
# Ligne vide
# Lignes suivantes : corps détaillé

Options utiles

git commit -v              # montre le diff dans l'éditeur
git commit -a -m "fix: typo"  # add + commit des fichiers suivis (pas les nouveaux)
git commit --amend -m "nouveau message"  # corrige le dernier commit (pas encore pushé)
git commit --amend --no-edit  # garde le message, corrige le contenu
git commit --allow-empty -m "chore: trigger CI"

Consulter l’historique : `git log` & `git show`

`git log` — la base

git log
# hash, Author, Date, message complet

git log --oneline
# 4f82d2c feat: initial commit
# a1b2c3d docs: update README

git log --oneline --graph --all --decorate
# * a1b2c3d (HEAD -> main) docs: update README
# * 4f82d2c feat: initial commit

git log --stat
#  README.md | 1 +
#  1 file changed...

git log -p
# patch complet

git log --since="2 days ago" --until="today"
git log --author="Aïda"
git log --grep="feat"

`git show` — zoom sur un commit

git show
# dernier commit

git show HEAD
git show a1b2c3d
git show HEAD~1

Commandes à exécuter

bash

# Cliquez sur les commandes à gauche pour les exécuter dans le simulateur

hashcode-academy:~$_

Conventions : Conventional Commits

Un bon message = lisible par humain + exploitable par outil (changelog auto, semver).

Format

<type>(<scope>): <sujet à l'impératif>

[corps]

[footer]

Préfixe	Usage	Exemple
`feat`	Nouvelle fonctionnalité	`feat: add dashboard`
`fix`	Correction bug	`fix: resolve login redirect`
`docs`	Documentation	`docs: update README`
`style`	Formatage	`style: format with prettier`
`refactor`	Refacto sans changement fonctionnel	`refactor: simplify auth`
`perf`	Performance	`perf: cache user lookup`
`test`	Tests	`test: add unit for login`
`chore`	Maintenance	`chore: update deps`
`revert`	Annulation	`revert: feat: add login`

Les 8 premiers types sont ceux de la spec Conventional Commits. Pour la sécurité, utilisez fix avec un scope : fix(security): sanitize inputs.

Mauvais vs Bon

❌ "modif" / "fix" / "update" / "changements divers"
✅ "feat(auth): add JWT refresh flow"
✅ "fix(api): handle null user in /me"
✅ "docs: add install steps for Windows"

Bonnes pratiques & pièges

Faites

Petits commits atomiques (1 logique = 1 commit) - git status + git diff avant chaque commit - Messages à l’impératif présent

Évitez

git commit -m "fix" sans contexte - git add . aveugle avec secrets - git commit -a qui masque l’index