Le lundi matin, enfin résolu
Souvenez-vous de la leçon 1.3 : deux cents utilisateurs sans lecteur réseau, un script modifié un vendredi soir, et cinq questions sans réponse.
Vous disposez maintenant de l’outillage. Cette leçon est celle où Git cesse d’être un système de sauvegarde pour devenir un outil d’investigation.
Quatre commandes suffisent. Nous les verrons d’abord séparément, puis assemblées en une méthode d’enquête.
git log — parcourir l’histoire
Vous connaissez la forme de base depuis la leçon 1.7. Voici ce qui la rend réellement utile.
Les vues
git log --oneline # une ligne par enregistrement
git log --stat # + les fichiers touchés et le volume
git log -p # + le détail des changements
git lg # l'alias configuré en 1.6, avec le graphe
--stat mérite d’être connu : il donne un aperçu immédiat de l’ampleur d’un changement.
7d2e881 Migration du partage compta vers SRV-FIC02
Logon.ps1 | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
Une ligne modifiée dans un fichier. On sait tout de suite que ce n’est pas cet enregistrement qui a cassé le serveur de fichiers.
Filtrer
C’est là que ça devient intéressant.
# Sur une période
git log --since="2026-08-01" --until="2026-08-10"
git log --since="3 days ago"
# Par auteur
git log --author="Nicolas"
# Par mot-clé dans le message
git log --grep="compta"
# Les N derniers
git log -5
Ces options se combinent librement :
git log --oneline --since="vendredi" --author="Nicolas"
Que Nicolas a-t-il publié depuis vendredi ? Une commande, trois secondes.
L’historique d’un seul fichier
git log --oneline -- Logon.ps1
Le double tiret sépare les options du chemin. Il évite l’ambiguïté quand un fichier porte le même nom qu’une branche — ce qui arrive plus souvent qu’on ne croit.
Avec le détail des changements à chaque étape :
git log -p -- Logon.ps1
Et si le fichier a été renommé au fil du temps :
git log --follow -- Logon.ps1
Sans --follow, l’historique s’arrête au renommage. Avec, Git remonte au-delà.
La commande la plus utile que personne ne connaît
git log -S "srv-fic01" --oneline
Cette option — surnommée la pioche — cherche les enregistrements où le nombre d’occurrences d’une chaîne a changé. Autrement dit : quand cette chaîne est-elle apparue, et quand a-t-elle disparu ?
Traduisez cela en questions d’administrateur système :
git log -S "srv-fic01" --oneline # quand a-t-on cessé d'utiliser ce serveur ?
git log -S "Invoke-Expression" --oneline # quand cet appel a-t-il été introduit ?
git log -S "192.168.10.15" --oneline # d'où sort cette adresse en dur ?
git log -S "-SkipCertificateCheck" # qui a désactivé la vérification TLS ?
Sur un référentiel de plusieurs centaines de scripts, cette commande répond en une seconde à des questions qui prendraient une matinée autrement.
La variante -G accepte une expression régulière plutôt qu’une chaîne littérale.
git show — examiner un enregistrement
git show 7d2e881
Affiche tout : auteur, date, message et le détail des changements.
C’est la commande de l’enquête : vous repérez un enregistrement suspect dans le log, vous l’ouvrez, vous voyez exactement ce qu’il contenait.
Quelques variantes utiles :
git show 7d2e881 --stat # juste les fichiers touchés
git show 7d2e881:Logon.ps1 # le fichier ENTIER à cette version
git show HEAD~3:Logon.ps1 > /tmp/ancien.ps1 # l'extraire pour comparer
La deuxième forme est précieuse : elle donne le contenu complet d’un fichier tel qu’il était à un instant donné, sans toucher à votre copie de travail.
Désigner un enregistrement
| Notation | Signification |
|---|---|
7d2e881 |
Par son empreinte — sept caractères suffisent |
HEAD |
Le dernier enregistrement de votre branche |
HEAD~1 |
Le précédent |
HEAD~5 |
Cinq en arrière |
main |
Le dernier de la branche main |
origin/main |
Votre dernière connaissance du serveur |
v1.4 |
Une version étiquetée (section 4) |
git diff — comparer deux états
Vous l’utilisez déjà pour voir vos modifications en cours. Ses autres formes sont tout aussi utiles.
git diff # établi vs dernier enregistrement
git diff --staged # plateau vs dernier enregistrement
git diff HEAD~3 HEAD # entre deux points de l'histoire
git diff HEAD~3 HEAD -- Logon.ps1 # idem, sur un seul fichier
git diff v1.3 v1.4 # entre deux versions publiées
git diff main origin/main # ce qui vous sépare du serveur
L’avant-dernière est celle que vous emploierez le plus en production : qu’est-ce qui a changé entre la version qui fonctionnait et celle qui ne fonctionne plus ?
Pour un aperçu avant de plonger :
git diff v1.3 v1.4 --stat
Logon.ps1 | 12 ++++++++----
Check-Espace.ps1 | 3 ++-
README.md | 8 ++++++++
3 files changed, 18 insertions(+), 5 deletions(-)
Astuce lisibilité : sur des fichiers de configuration, --word-diff met en évidence les mots modifiés plutôt que les lignes entières. Très pratique sur un nginx.conf où une seule directive a changé au milieu d’une longue ligne.
git blame — qui a écrit cette ligne
git blame Logon.ps1
a3f9c21 (Romain Dupont 2026-03-12 09:14:22 +0100 1) # Logon.ps1 - Script de connexion
a3f9c21 (Romain Dupont 2026-03-12 09:14:22 +0100 2) $groupes = (Get-ADUser ...
7d2e881 (Nicolas Marchand 2026-08-04 09:15:41 +0200 9) New-PSDrive -Name "P" ... srv-fic02 ...
Pour chaque ligne : l’enregistrement, l’auteur, la date.
Le nom de la commande est malheureux — il ne s’agit pas de désigner un coupable, mais de retrouver le contexte. Dans notre métier, la question est presque toujours « pourquoi cette ligne existe-t-elle ? », rarement « qui a fauté ? ».
Cibler une zone
Sur un fichier de mille lignes, limitez-vous :
git blame -L 40,55 Logon.ps1 # les lignes 40 à 55
git blame -L '/srv-fic02/',+5 Logon.ps1 # 5 lignes à partir du premier motif trouvé
La limite à connaître
git blame montre le dernier enregistrement ayant touché la ligne, pas celui qui l’a introduite.
Une correction de faute de frappe ou un simple ré-indentage suffit à masquer l’auteur d’origine. Deux réponses :
git blame -w Logon.ps1 # ignorer les changements d'espacement
git blame -C Logon.ps1 # suivre le code déplacé d'un fichier à l'autre
Et pour remonter plus loin, relancez la commande juste avant l’enregistrement trouvé :
git blame 7d2e881^ -- Logon.ps1
Le ^ signifie « le parent de ». Vous voyez l’état de la ligne avant ce changement, et vous pouvez répéter l’opération jusqu’à l’origine.
La méthode d’enquête
Assemblons tout cela. Vous découvrez une ligne suspecte dans un script :
Invoke-RestMethod $url -SkipCertificateCheck
Étape 1 — Qui, quand ?
git blame -L '/SkipCertificateCheck/',+1 -- Deploy.ps1
b91c4f2 (Nicolas Marchand 2026-05-22 17:48:03 +0200 87) Invoke-RestMethod $url -SkipCertificateCheck
Étape 2 — Pourquoi ?
git show b91c4f2
Le message d’enregistrement donne l’intention. Avec un peu de chance : « Contournement temporaire, certificat du serveur de test expiré — à retirer ». Trois mois plus tard, personne ne l’a retiré.
Étape 3 — Est-ce isolé ?
git log -S "SkipCertificateCheck" --oneline
Si trois enregistrements remontent, la pratique s’est répandue. Ce n’est plus un contournement, c’est une habitude à corriger.
Étape 4 — Qu’y avait-il avant ?
git blame b91c4f2^ -- Deploy.ps1
Quatre commandes, deux minutes, et vous avez la chronologie complète d’une décision technique.
Comparez avec le lundi matin de la leçon 1.3. C’est exactement la différence que fait un historique.
Depuis l’interface de la forge
Tout ce qui précède existe aussi en version graphique, et c’est parfois plus rapide.
Sur la page d’un fichier, trois boutons : Historique (les enregistrements qui l’ont touché), Blame (l’attribution ligne par ligne, avec les liens vers chaque enregistrement) et Brut (le contenu seul — nous le retrouverons en section 7).
L’onglet Commits du dépôt permet de filtrer par auteur et par période, et chaque enregistrement s’ouvre sur son diff complet.
L’avantage du web : les liens. Depuis une ligne dans Blame, un clic mène à l’enregistrement, puis à la pull request qui l’a intégré, puis au ticket qui l’avait motivé. C’est la chaîne de contexte que nous construirons en section 13.
L’avantage de la ligne de commande : git log -S, qui n’a pas d’équivalent web, et la possibilité de combiner les filtres.
Utilisez les deux selon le besoin.
Les pièges
| Symptôme | Cause |
|---|---|
| L’historique du fichier s’arrête brutalement | Il a été renommé : utilisez --follow |
git log <fichier> renvoie une erreur |
Ajoutez le séparateur : git log -- <fichier> |
blame désigne quelqu’un qui n’a fait qu’un ré-indentage |
Utilisez -w |
| Vous cherchez du texte et ne trouvez rien | --grep cherche dans les messages, -S dans le contenu |
| L’historique semble incomplet | Vous n’avez peut-être pas tiré : git fetch |
git log reste bloqué à l’écran |
C’est le pagineur : q pour sortir |
Ce qu’il faut retenir
git log --statdonne l’ampleur d’un changement en un coup d’œil.- Les filtres se combinent :
--since,--author,--grep,-5. git log -- <fichier>isole l’historique d’un fichier ;--followtraverse les renommages.git log -S "chaîne"trouve quand une chaîne est apparue ou a disparu — la commande la plus utile de cette leçon.git show <empreinte>:<fichier>extrait un fichier entier à une version donnée.git diff v1.3 v1.4répond à « qu’est-ce qui a changé entre la version qui marchait et l’autre ».git blamemontre le dernier qui a touché la ligne :-wet<commit>^pour remonter plus loin.- L’interface web excelle pour naviguer ; la ligne de commande pour chercher.
Dans la leçon suivante
Vous savez enquêter. Reste à savoir réparer.
La leçon 3.8 traite les trois commandes du retour en arrière — restore, revert et reset — que tout le monde confond, et pour cause : elles portent des noms voisins et font des choses radicalement différentes. L’une annule vos modifications en cours, l’autre annule un enregistrement publié en en créant un nouveau, la troisième réécrit votre historique local.
Choisir la mauvaise, c’est au mieux perdre son travail, au pire semer la pagaille chez ses collègues. Nous verrons une règle simple pour ne jamais se tromper.