git mv
git
Syntaxe
git mv [-f] <source> <destination>Déplace un fichier et indexe le changement d'un coup ; git n'enregistre pas les renommages, il les déduit du contenu, donc un changement de casse seul exige -f sous macOS et Windows.
Options courantes
| Option | Signification |
|---|---|
| -f | overwrite the destination |
| -k | skip moves that would fail instead of stopping |
| -n | dry run |
| -v | name each file as it moves |
Exemples
git mv old.md docs/new.mdmoves the file and stages the change in one step
git mv -n src/a.ts src/b.tsshows what it would do
git mv README.md readme.mda case-only rename, which needs -f on macOS and Windows
Ce qui embrouille, c’est qu’annuler a plusieurs formes : déplacer là où pointe une branche n’est pas ajouter un commit qui l’inverse.
Comment lire
- Les crochets [ ] marquent une partie facultative.
- Les points de suspension … signifient qu’on peut en mettre plusieurs.
- Les options sont sensibles à la casse : sur certaines commandes, -r et -R ne font pas la même chose.
Questions fréquentes
Q. Que fait git mv ?
Déplace un fichier et indexe le changement d'un coup ; git n'enregistre pas les renommages, il les déduit du contenu, donc un changement de casse seul exige -f sous macOS et Windows.
Q. Comment l’écrire ?
git mv [-f] <source> <destination> — les crochets marquent ce qui est facultatif.
Q. Combien d’options valent la peine ?
Il y en a 4 ici ; la liste complète est dans man git. Cette commande relève de git.
Commandes liées
page man: man git-mv