Aller au contenu principal
Télécharger

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 ton répertoire actuel ni dans aucun répertoire parent. Voici comment la diagnostiquer et la corriger en quelques secondes.

GitQuest
Démo
Erreur expliquée

Ce que cette erreur signifie

Lorsque tu vois fatal: not a git repository (or any of the parent directories): .git, Git t'indique qu'il a cherché un dossier .git/ dans ton répertoire actuel et dans chaque répertoire parent au-dessus, mais n'a rien trouvé.

Le dossier .git/ est le répertoire caché qui stocke l'intégralité de ton dépôt : commits, branches, configuration et historique. Sans lui, Git n'a aucun dépôt avec lequel travailler et chaque commande Git échouera.

Cette erreur n'affecte pas tes fichiers source. Ton code est en sécurité. Tu dois simplement indiquer à Git où se trouve le dépôt, ou en créer un.

Pourquoi cela se produit

Le plus courant

Mauvais répertoire

Tu as ouvert un terminal ou un IDE dans un dossier qui n'est pas la racine de ton projet. Tu es peut-être dans ton répertoire personnel, sur le Bureau, ou dans un dossier parent qui ne contient pas de répertoire .git/. C'est de loin la cause la plus fréquente.

Facile à oublier

Dépôt pas encore créé

Tu as créé un nouveau dossier de projet mais tu as oublié de lancer git init ou git clone. Le dossier existe mais ce n'est pas encore un dépôt Git. Git doit être explicitement initialisé avant de pouvoir suivre les modifications.

Rare mais grave

Le dossier .git a été supprimé

Quelqu'un (ou un script) a accidentellement supprimé le dossier .git/. Cela supprime tout l'historique de version de la machine locale. Si le projet existe sur un serveur distant comme GitHub, tu peux le récupérer en le clonant à nouveau. Sinon, l'historique est perdu.

Comment corriger

Trois solutions selon ta situation. Commence par la première, qui résout le problème dans la plupart des cas.

Naviguer vers le bon dossier

Initialiser un nouveau dépôt

Cloner depuis le distant

Comment prévenir cette erreur

Toujours ouvrir la racine du projet dans ton IDE

Dans VS Code, utilise Fichier > Ouvrir un dossier et sélectionne le répertoire qui contient le dossier .git/. Ouvrir un dossier parent ou voisin provoquera cette erreur dans le terminal intégré.

Vérifier ton répertoire avant de lancer Git

Prends l'habitude de lancer pwd avant toute commande Git dans une nouvelle session de terminal. Cela prend une seconde et évite la confusion, surtout lorsque tu as plusieurs projets ouverts.

Pousser régulièrement vers un dépôt distant

Si ton dossier .git/ est un jour accidentellement supprimé, avoir une sauvegarde distante sur GitHub ou GitLab signifie que tu peux toujours récupérer le dépôt complet avec git clone.

A

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 reste plus jamais bloqué·e sur une erreur Git

GitQuest t'apprend Git par la pratique. Comprends chaque commande, chaque erreur, chaque correctif.