git mvで、ファイル名の大文字と小文字を変える方法

​​Git​コマンドライン

ファイル名の大文字と小文字だけを変えるときは、mv ではなく git mv readme.md README.md のように git mv で変えます。git-config の公式リファレンスによると、macOS(APFS など)や Windows(NTFS など)のファイルシステムは大文字と小文字を区別しません。そうした環境を再現した検証環境では、mv で名前を変えても git status に何も出ず、コミットもできませんでした。リモートにも古い名前のまま残り、大文字と小文字を区別する環境にクローンすると古い名前で出てきます。この食い違いが起きる様子と、git mv で直す手順を、前と後の出力を見ながら確かめました。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。大文字と小文字を区別しないファイルシステムは、Linux の上で ciopfs(FUSE で動く、大文字と小文字を区別しないファイルシステム)を使って再現しました。macOS や Windows の実機では試していません。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定しました。リモートは、同じ環境の中に作った空のリポジトリで代用しています。フォルダ名の大文字と小文字を変える場合は試していません。

大文字と小文字を区別しない環境では、名前を変えても Git が気づかない

ciopfs で作ったフォルダの中で試しました。まず、このフォルダが大文字と小文字を区別しないことを確かめます。test.txt を作って TEST.TXT を開くと、同じファイルの中身が表示されました。

console
$ printf "a\n" > test.txt && cat TEST.TXT && rm test.txt
a

この中で git init したリポジトリでは、core.ignorecase が true になっていました。

console
$ git init -q app && cd app

$ git config core.ignorecase
true

core.ignoreCase の説明(git-config の公式リファレンス)によると、git init と git clone は、リポジトリを作るときにファイルシステムを調べて、必要なら core.ignoreCase を true にします。説明には、Git が「Makefile」を期待しているところで「makefile」が見つかったら同じファイルとみなし、「Makefile」として覚え続ける、という例があります。

readme.md をコミットし、リモート役の空のリポジトリを作業用のフォルダの直下に作って push しておきます。

console
$ printf "# 猫の手ストア\n" > readme.md && git add . && git commit -q -m "最初のコミット"

$ git init -q --bare ../../remote.git && git remote add origin ../../remote.git && git push -q -u origin main

ここで mv を使って README.md に変えてみます。

console
$ mv readme.md README.md

$ ls
README.md

$ git status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

$ git ls-files
readme.md

ls では README.md になっているのに、git status は「nothing to commit」で、Git が記録している名前(git ls-files)は readme.md のままです。git commit -a でも、コミットするものがないと言われました。

console
$ git commit -a -m "README のファイル名を大文字に"
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

コミットできないので、リモートにも readme.md のまま残ります。この時点のリモートを、大文字と小文字を区別するふつうのフォルダにクローンすると、ファイル名は readme.md でした。

console
$ (cd "$W/cs" && git clone -q ../remote.git before && ls before)
readme.md

$W は作業用のフォルダを指す変数で、cs はその中にある、大文字と小文字を区別するふつうのフォルダです。

git mv で変えると、Git の記録も新しい名前になる

同じリポジトリで git mv readme.md README.md を実行します。上で mv だけ済ませてディスク上の名前が README.md になっている状態からでも、そのまま実行できました。

console
$ git mv readme.md README.md

$ git status
On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	renamed:    readme.md -> README.md


$ git ls-files
README.md

今度は renamed: readme.md -> README.md と表示され、Git の記録も README.md に変わりました。git mv の公式リファレンスにあるとおり、git mv は名前を変えたあとにインデックス(次のコミットに入る内容)も更新します。あとはふつうにコミットします。

console
$ git commit -q -m "README のファイル名を大文字に" && git log --stat --oneline -1
9703ad3 README のファイル名を大文字に
 readme.md => README.md | 0
 1 file changed, 0 insertions(+), 0 deletions(-)

push してから、区別するファイルシステムにもう一度クローンすると、今度は README.md で出てきました。

console
$ git push -q origin main

$ (cd "$W/cs" && git clone -q ../remote.git after && ls after)
README.md
大文字と小文字を区別しない環境で readme.md を README.md に変えたとき、mv だけではディスク上の名前は README.md、Git の記録は readme.md のままで git status は変更なし。git mv ではどちらも README.md になり、git status に renamed と出ることを示す図
mv だけで変えた場合と、git mv で変えた場合の違い

大文字と小文字を区別する環境での動き

大文字と小文字を区別するふつうのフォルダでは、mv で名前を変えると、Git からは「readme.md が消えて、README.md という新しいファイルができた」ように見えます。

console
$ mv readme.md README.md

$ ls
README.md

$ git status
On branch main
Changes not staged for commit:
  (use "git add/rm <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	deleted:    readme.md

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	README.md

no changes added to commit (use "git add" and/or "git commit -a")

名前の変更としては表示されません。いったん mv で名前を戻してから git mv を使うと、区別しない環境と同じく renamed として1回で記録されました。

console
$ mv README.md readme.md

$ git mv readme.md README.md

$ git status
On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	renamed:    readme.md -> README.md

大文字と小文字だけを変えるときは、どちらの環境でも git mv を使えば、名前の変更として1回で記録できます。

git mv を取り消すときは、ディスク上の名前も戻す

区別しない環境で git mv README.md Readme.md をしたあと、git restore --staged で取り消すと、Git の記録だけが元に戻り、ディスク上の名前は Readme.md のまま残りました。それでも git status には何も出ません。

console
$ git mv README.md Readme.md

$ git status --short
R  README.md -> Readme.md

$ git restore --staged README.md Readme.md

$ git status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

$ git ls-files
README.md

$ ls
Readme.md

この食い違いは git status では見つけられないので、ls と git ls-files を見比べて確かめます。ディスク上の名前は、mv Readme.md README.md で戻しました。

console
$ mv Readme.md README.md

$ ls
README.md

$ git status --short
注意

core.ignoreCase を false に書き換えて、区別しない環境で名前の変更を Git に気づかせようとするのは避けてください。core.ignoreCase の説明には、Git はこの値が OS とファイルシステムに合わせて正しく設定されていることを前提にしており、変えると予期しない動きになることがある、と書かれています。

​Posted by 86