Git mv : renommer ou déplacer un fichier
git mv renomme ou déplace un fichier tout en gardant le suivi Git. Plus propre que de faire mv + git add, il préserve l'historique.
Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le
C'est quoi git mv ?
git mv est un raccourci pour renommer ou déplacer un fichier tout en informant Git du changement. C'est équivalent à faire mv + git add en une seule commande.
L'avantage : Git comprend que c'est un renommage, pas une suppression + création. L'historique du fichier est mieux préservé.
Syntaxe de git mv
git mv ancien nouveauRenommer un fichier
git mv fichier dossier/Déplacer dans un autre dossier
git mv -f Fichier.js fichier.jsForcer le renommage (utile pour la casse)
Git mv en pratique
Renommer ou déplacer des fichiers proprement.
Renommer un fichier
Déplacer des fichiers
git mv vs mv + git add
git mv
Une commande : déplace et stage en une étape. Git détecte immédiatement le renommage.
mv + git add
Deux commandes : déplacer puis stager manuellement. Git détecte quand même le renommage.
Erreurs courantes avec git mv
Renommer la casse sur macOS/Windows
Ces systèmes sont insensibles à la casse. git mv Header.js header.js peut échouer. Utilise -f pour forcer ou fais un renommage en deux étapes via un nom temporaire.
Déplacer vers un dossier qui n'existe pas
git mv ne crée pas les dossiers automatiquement. Crée le dossier de destination avant avec mkdir -p.
Oublier de mettre à jour les imports
Renommer un fichier ne met pas à jour les références dans le code (imports, require). Pense à mettre à jour tous les fichiers qui utilisent l'ancien chemin.
Fait partie du guide Git avancé
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 git mv
Organise ton dépôt avec GitQuest
Apprends à structurer proprement tes projets Git grace aux enquêtes interactives.