Que signifie "fatal: not a git repository" ?

Cette erreur signifie que Git ne trouve pas de repertoire .git dans votre dossier actuel ni dans aucun de ses dossiers parents. Le repertoire .git est ce qui fait d'un dossier un depot Git. Sans lui, les commandes Git n'ont aucun depot sur lequel operer.

Comment verifier si je suis dans un depot Git ?

Lancez "git rev-parse --is-inside-work-tree" dans votre terminal. Si la commande affiche "true", vous etes dans un depot Git. Si elle renvoie l'erreur "fatal: not a git repository", vous n'y etes pas. Vous pouvez aussi verifier si un dossier .git existe en lancant "ls -la" et en le recherchant.

J'ai supprime mon dossier .git par accident. Puis-je le recuperer ?

Si vous avez supprime .git localement mais que le depot existe sur un serveur distant (GitHub, GitLab, etc.), vous pouvez le recuperer en le clonant a nouveau avec "git clone". S'il n'existe pas de copie distante, l'historique est perdu definitivement. Vos fichiers source sont toujours intacts, mais tous les commits, branches et tags ont disparu. C'est pourquoi il est important de pousser regulierement vers un depot distant.

Pourquoi est-ce que j'obtiens cette erreur dans VS Code ou mon IDE ?

Votre IDE a probablement ouvert un dossier parent qui n'est pas un depot Git, ou un sous-dossier au lieu de la racine du projet. Assurez-vous d'ouvrir le dossier qui contient le repertoire .git. Dans VS Code, utilisez Fichier > Ouvrir un dossier et selectionnez la bonne racine de projet.

Puis-je obtenir cette erreur dans un sous-repertoire d'un depot Git ?

Non. Git remonte automatiquement les repertoires parents jusqu'a trouver un dossier .git. Si vous etes n'importe ou a l'interieur d'un depot Git, meme profondement imbrique, Git le trouvera. Cette erreur ne se produit que lorsqu'aucun dossier .git n'existe dans aucun repertoire parent jusqu'a la racine du systeme de fichiers.

fatal: not a git repository Comment corriger cette erreur Git

C'est l'erreur Git la plus courante. Elle signifie que Git ne trouve pas de dossier .git dans votre repertoire actuel ni dans aucun repertoire parent. Voici comment la diagnostiquer et la corriger en quelques secondes.

Apprendre Git pas a pas Glossaire Git

gitquest — enquête

Erreur expliquee

Ce que cette erreur signifie

Lorsque vous voyez fatal: not a git repository (or any of the parent directories): .git, Git vous indique qu'il a cherche un dossier .git/ dans votre repertoire actuel et dans chaque repertoire parent au-dessus, mais n'a rien trouve.

Le dossier .git/ est le repertoire cache qui stocke l'integralite de votre depot : commits, branches, configuration et historique. Sans lui, Git n'a aucun depot avec lequel travailler et chaque commande Git echouera.

Cette erreur n'affecte pas vos fichiers source. Votre code est en securite. Vous devez simplement indiquer a Git ou se trouve le depot, ou en creer un.

gitquest — erreur

# Vous lancez une commande Git et voyez cette erreur

$git status

fatal: not a git repository (or any of the parent directories): .git

# Git ne trouve aucun dossier .git au-dessus de votre emplacement actuel

Pourquoi cela se produit

Le plus courant

Mauvais repertoire

Vous avez ouvert un terminal ou un IDE dans un dossier qui n'est pas la racine de votre projet. Vous etes peut-etre dans votre repertoire personnel, sur le Bureau, ou dans un dossier parent qui ne contient pas de repertoire .git/. C'est de loin la cause la plus frequente.

Facile a oublier

Depot pas encore cree

Vous avez cree un nouveau dossier de projet mais avez oublie de lancer git init ou git clone. Le dossier existe mais ce n'est pas encore un depot Git. Git doit etre explicitement initialise avant de pouvoir suivre les modifications.

Rare mais grave

Le dossier .git a ete supprime

Quelqu'un (ou un script) a accidentellement supprime le dossier .git/. Cela supprime tout l'historique de version de la machine locale. Si le projet existe sur un serveur distant comme GitHub, vous pouvez le recuperer en le clonant a nouveau. Sinon, l'historique est perdu.

Comment corriger

Trois solutions selon votre situation. Commencez par la premiere, qui resout le probleme dans la plupart des cas.

Naviguer vers le bon dossier

gitquest — correctif cd

# Correctif 1 : Naviguez vers le bon repertoire de projet

$pwd

/home/user

$cd ~/projects/my-app

$git status

On branch main

nothing to commit, working tree clean

Initialiser un nouveau depot

gitquest — correctif init

# Correctif 2 : Initialisez un nouveau depot ici

$git init

Initialized empty Git repository in /home/user/my-project/.git/

$git status

On branch main

No commits yet

Cloner depuis le distant

gitquest — correctif clone

# Correctif 3 : Clonez le depot depuis le serveur distant

$git clone https://github.com/user/my-project.git

Cloning into 'my-project'...

remote: Enumerating objects: 42, done.

Receiving objects: 100% (42/42), done.

$cd my-project && git status

On branch main

Comment prevenir cette erreur

Toujours ouvrir la racine du projet dans votre IDE

Dans VS Code, utilisez Fichier > Ouvrir un dossier et selectionnez le repertoire qui contient le dossier .git/. Ouvrir un dossier parent ou voisin provoquera cette erreur dans le terminal integre.

Verifier votre repertoire avant de lancer Git

Prenez l'habitude de lancer pwd avant toute commande Git dans une nouvelle session de terminal. Cela prend une seconde et evite la confusion, surtout lorsque vous avez plusieurs projets ouverts.

Pousser regulierement vers un depot distant

Si votre dossier .git/ est un jour accidentellement supprime, avoir une sauvegarde distante sur GitHub ou GitLab signifie que vous pouvez toujours recuperer le depot complet avec git clone.

Commandes associees

git init

Initialiser un nouveau depot Git depuis zero

git clone

Cloner un depot existant depuis une URL distante

git status

Verifier l'etat actuel de votre depot

GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.

Questions sur cette erreur

Ne restez plus jamais bloque sur une erreur Git

GitQuest vous apprend Git par la pratique. Comprenez chaque commande, chaque erreur, chaque correctif.

Commencer a apprendre Git