git mv

git

書き方

git mv [-f] <source> <destination>

ファイルを移動して、その事実をそのままステージに載せます。gitは改名を保存せず内容の似かたから推測するので、大文字小文字だけ変える改名はmacOSやWindowsで-fが必要です。

よく使うオプション

オプション意味
-foverwrite the destination
-kskip moves that would fail instead of stopping
-ndry run
-vname each file as it moves

git mv old.md docs/new.md

moves the file and stages the change in one step

git mv -n src/a.ts src/b.ts

shows what it would do

git mv README.md readme.md

a case-only rename, which needs -f on macOS and Windows

取り消しに何通りもあるのが混乱のもとです — ブランチの指す先を動かすのと、打ち消すコミットを積むのは別です。

読み方

  • 角括弧 [ ] は省いてよい部分です。
  • 三点 … は複数並べられるという意味です。
  • オプションは大文字小文字を区別します — -r と -R が別物のコマンドもあります。

よくある質問

Q. git mv は何をしますか。

ファイルを移動して、その事実をそのままステージに載せます。gitは改名を保存せず内容の似かたから推測するので、大文字小文字だけ変える改名はmacOSやWindowsで-fが必要です。

Q. どう打ちますか。

git mv [-f] <source> <destination> — 角括弧は省いてよい部分です。

Q. よく使うオプションはいくつですか。

ここにまとめたのは4個です。全部は man git にあります。このコマンドはgitの仲間です。

関連するコマンド

man ページ: man git-mv