Aller au contenu principal

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.

GitQuest
Démo

Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le

Organisation

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 nouveau

Renommer un fichier

git mv fichier dossier/

Déplacer dans un autre dossier

git mv -f Fichier.js fichier.js

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

Recommandé pour la clarté

mv + git add

Deux commandes : déplacer puis stager manuellement. Git détecte quand même le renommage.

Fonctionne mais plus verbeux

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é

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 git mv

Organise ton dépôt avec GitQuest

Apprends à structurer proprement tes projets Git grace aux enquêtes interactives.