// Git Toolbox

Inspecteur .git

Le dossier .git, c'est le cerveau de ton dépôt. Voici à quoi sert chaque partie, ce que tu peux toucher, et ce qu'il raconte sur ton dépôt.

Contenu de .git

HEADN'y touche pas
Là où tu es : en général « ref: refs/heads/main ». Un hash brut veut dire HEAD détachée.
DestructriceN'y touche pas
Regarder dedans
Sans risque
$ cat .git/HEAD
configAvec précaution
Les réglages de ce dépôt : remotes, suivi des branches, options locales. Modifie-le avec git config plutôt qu'à la main.
PrudenceAvec précaution
Regarder dedans
Sans risque
$ git config --local --list
descriptionTu peux y toucher
Utilisé seulement par GitWeb. Tu peux l'ignorer.
Sans risqueTu peux y toucher
indexN'y touche pas
La zone de staging : la photo exacte de ton prochain commit (fichier binaire).
DestructriceN'y touche pas
Regarder dedans
Sans risque
$ git ls-files --stage
objects/N'y touche pas
La base de données : chaque version de chaque fichier (blobs), dossier (trees), commit et tag annoté, compressés et nommés par leur hash.
DestructriceN'y touche pas
Regarder dedans
Sans risque
$ git count-objects -vH
- pack/N'y touche pas
  Les objets regroupés (.pack + .idx), avec des deltas entre versions. Créés par clone, fetch et git gc.
  DestructriceN'y touche pas
  Regarder dedans
  Sans risque
  $ git verify-pack -v .git/objects/pack/*.idx | sort -k3 -n | tail -5
- info/Tu peux y toucher
  Infos annexes de la base d'objets (alternates, liste des packs).
  Sans risqueTu peux y toucher
- a1//N'y touche pas
  Objets en vrac : les 2 premiers caractères du hash en dossier, les 38 autres en nom de fichier.
  DestructriceN'y touche pas
  Regarder dedans
  Sans risque
  $ git cat-file -p <hash>
refs/Avec précaution
Branches, tags et branches distantes : de petits fichiers texte qui contiennent un hash de commit.
PrudenceAvec précaution
Regarder dedans
Sans risque
$ git show-ref
- heads/Avec précaution
  Tes branches locales. refs/heads/main contient le hash du dernier commit de main.
  PrudenceAvec précaution
  Regarder dedans
  Sans risque
  $ git branch -v
- tags/Avec précaution
  Tes tags (v1.0.0…).
  PrudenceAvec précaution
  Regarder dedans
  Sans risque
  $ git tag -n
- remotes/Tu peux y toucher
  Le dernier état connu des branches distantes (origin/main…), mis à jour par fetch.
  Sans risqueTu peux y toucher
  Regarder dedans
  Sans risque
  $ git branch -r
- stashAvec précaution
  Tes stashs.
  PrudenceAvec précaution
  Regarder dedans
  Sans risque
  $ git stash list
packed-refsAvec précaution
Beaucoup de refs dans un seul fichier, pour la vitesse. Une branche peut être ici au lieu de refs/heads/.
PrudenceAvec précaution
Regarder dedans
Sans risque
$ cat .git/packed-refs
logs/Avec précaution
Le reflog : chaque position qu'ont eue HEAD et chaque branche. C'est ce qui te sauve après un mauvais reset.
PrudenceAvec précaution
Regarder dedans
Sans risque
$ git reflog
En savoir plus →
hooks/Tu peux y toucher
Des scripts lancés par Git à des moments clés (pre-commit, pre-push…). Les fichiers .sample sont des exemples inactifs.
Sans risqueTu peux y toucher
En savoir plus →
info/Tu peux y toucher
info/exclude : un .gitignore personnel qui n'est jamais commité.
Sans risqueTu peux y toucher
Regarder dedans
Sans risque
$ cat .git/info/exclude
COMMIT_EDITMSGTu peux y toucher
Le message de ton dernier commit, tel que tapé dans l'éditeur.
Sans risqueTu peux y toucher
FETCH_HEADtemporaireTu peux y toucher
Ce que le dernier fetch a ramené.
Sans risqueTu peux y toucher
Regarder dedans
Sans risque
$ cat .git/FETCH_HEAD
ORIG_HEADtemporaireTu peux y toucher
Où était HEAD avant la dernière opération risquée (merge, rebase, reset).
Sans risqueTu peux y toucher
Regarder dedans
Sans risque
$ git log -1 ORIG_HEAD
MERGE_HEADtemporaireN'y touche pas
Le commit en train d'être mergé.
DestructriceN'y touche pas
En savoir plus →
MERGE_MSGtemporaireTu peux y toucher
Le message préparé du commit de merge.
Sans risqueTu peux y toucher
rebase-merge/temporaireN'y touche pas
L'état d'un rebase (interactif ou non).
DestructriceN'y touche pas
En savoir plus →
rebase-apply/temporaireN'y touche pas
L'état d'un git am ou d'un rebase à l'ancienne.
DestructriceN'y touche pas
CHERRY_PICK_HEADtemporaireN'y touche pas
Le commit en train d'être cherry-pické.
DestructriceN'y touche pas
REVERT_HEADtemporaireN'y touche pas
Le commit en train d'être annulé.
DestructriceN'y touche pas
BISECT_LOGtemporaireTu peux y toucher
Les étapes d'un git bisect.
Sans risqueTu peux y toucher
sequencer/temporaireN'y touche pas
L'état d'un cherry-pick ou d'un revert de plusieurs commits.
DestructriceN'y touche pas
index.locktemporaireAvec précaution
Un verrou pris par une commande Git en cours.
PrudenceAvec précaution
En savoir plus →
shallowtemporaireAvec précaution
Les commits où l'historique s'arrête (clone --depth).
PrudenceAvec précaution
modules/Avec précaution
Les dépôts de tes sous-modules.
PrudenceAvec précaution
Regarder dedans
Sans risque
$ git submodule status
worktrees/Avec précaution
Les dossiers de travail en plus créés avec git worktree add.
PrudenceAvec précaution
Regarder dedans
Sans risque
$ git worktree list
lfs/Avec précaution
Git LFS : les copies locales des gros fichiers.
PrudenceAvec précaution
Regarder dedans
Sans risque
$ git lfs ls-files
AUTO_MERGEtemporaireTu peux y toucher
Git récent (2.42+) : l'arbre que Git a fusionné tout seul au dernier merge, conflits compris. Pratique pour voir ce que tu as changé en résolvant.
Sans risqueTu peux y toucher
Regarder dedans
Sans risque
$ git diff AUTO_MERGE
gc.logtemporaireTu peux y toucher
Les erreurs du dernier git gc automatique.
Sans risqueTu peux y toucher

Les 4 types d'objets

blob: le contenu d'un fichier (pas son nom)
tree: un dossier : des noms → des blobs et d'autres trees
commit: un tree + parent(s) + auteur + message
tag: un tag annoté : un nom et un message sur un commit

Voir n'importe quel objet : git cat-file -p 1a2b3c4

Et dans le tien ?

Colle le contenu de ton dossier .git : l'inspecteur te dit ce qui se passe (merge en cours, verrou oublié…).

Sans risque

$ ls -la .git

Sans risque

$ Get-ChildItem -Force .git

2. Colle le résultat

Tout reste dans ton navigateur.