Aller au contenu principal
Télécharger

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.

Erreur courante

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.

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 pathspec did not match

Ne devine plus, comprends Git

GitQuest t'apprend Git par la pratique pour que les messages d'erreur deviennent clairs.