pathspec did not match any files — Comment corriger
Cette erreur Git signifie que le fichier ou la branche que tu as référencé n'existe pas, n'est pas suivi, ou contient une faute de frappe. Voici comment trouver et corriger le problème.
Ce que cette erreur signifie
Lorsque Git affiche error: pathspec 'file' did not match any file(s) known to git, cela signifie qu'il a parcouru son index et sa liste de branches sans trouver rien qui corresponde au nom que tu as fourni.
Un pathspec est simplement le chemin de fichier ou le nom de branche que tu passes à une commande Git. Si ce nom ne correspond à aucun fichier suivi, à aucune branche existante, ou à aucun chemin valide, Git abandonne et affiche cette erreur.
La bonne nouvelle : cette erreur ne provoque jamais de perte de données. C'est Git qui te dit "je ne trouve pas ce que tu cherches" avant de faire quoi que ce soit.
Pourquoi cela se produit
Faute de frappe dans le nom du fichier ou de la branche
La cause la plus courante. Tu as tapé feture au lieu de feature, ou oublié un répertoire dans le chemin. Git compare les noms exactement — il n'y a pas de recherche approximative.
Fichier non suivi par Git
Si tu as créé un nouveau fichier mais n'as jamais lancé git add, Git ne le connaît pas. Les commandes comme git checkout ou git stash ne peuvent pas trouver les fichiers non suivis.
Différence de casse
Linux traite App.js et app.js comme des fichiers différents. macOS et Windows non. Les équipes multi-plateformes rencontrent souvent ce problème lorsque les noms de fichiers ont été commités avec une casse différente.
Comment corriger
Suis ces étapes pour trouver la différence et résoudre l'erreur.
1. Vérifier avec git status
2. Ajouter ou récupérer la cible
3. Corriger la casse
Comment prévenir cette erreur
Utiliser la complétion par tabulation
Tape les premiers caractères d'un nom de fichier ou de branche et appuie sur Tab. Ton shell complétera automatiquement le nom ou te montrera les options disponibles. Cela élimine les fautes de frappe.
Lancer git status au préalable
Avant de lancer des commandes destructives ou complexes, lance git status pour voir exactement quels fichiers sont suivis, modifiés et non suivis. Cela prend une seconde et fait gagner du temps de débogage.
Convenir de conventions de nommage
Utilise des noms de fichiers en minuscules et des noms de branches en kebab-case dans ton équipe. Cela évite les surprises de casse lorsque les collaborateurs travaillent sur différents systèmes d'exploitation.
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 pathspec did not match
Ne devine plus, comprends Git
GitQuest t'apprend Git par la pratique pour que les messages d'erreur deviennent clairs.