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.
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
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.
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.
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.
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.