本記事はアフィリエイトリンクを含みます。Amazon のアソシエイトとして、TechAthletes は適格販売により収入を得ています。価格・割引・在庫は変動するため、最新の条件は各公式サイトでご確認ください。
要点
- 大文字小文字を区別しないAPFSでは、
mvで名前を変えてもGitの記録は元の名前のままだった(出典: 自社の実測・2026-11-06) git mvでは名前の変更として表示され、コミット後の記録も変更後の名前になった(出典: 自社の実測・2026-11-06)core.ignorecase=falseで変更・追加すると、大小文字だけが異なる名前が両方記録された(出典: 自社の実測・2026-11-06)- その履歴のcloneでは、大小文字を区別するAPFSと区別しないAPFSで、作業ツリーの結果が異なった(出典: 自社の実測・2026-11-06)
名前を変えたのにGitの変更に入らない
Foo.txtをfoo.txtに変えた。lsでは変更後の名前が見える。それでも、git status --shortには何も出ない。今回、大文字小文字を区別しないAPFSで確認したのは、この食い違いだ。
測定環境はmacOSで、diskutil info /のFile System PersonalityはAPFS。Gitのバージョン出力はgit version 2.50.1 (Apple Git-155)だった。シェルスクリプトでリポジトリを作り、Foo.txtをコミットしてから、名前の変更とGitの記録を確認した。
最初の操作では、git init後のcore.ignorecaseはtrueだった。その状態で通常のmvを実行した記録が次のとおりだ。
$ git config core.ignorecase
true
$ mv Foo.txt foo.txt
$ ls
foo.txt
$ git status --short
(git status の出力はここまで=変更なし)
$ git ls-files
Foo.txt
括弧内の行は、git statusの出力が空だったことを示す記録上の注記だ。ディスク上ではfoo.txtと表示されている一方、git ls-filesにはFoo.txtが残っている。ファイル一覧の見た目だけでは、Gitに名前の変更が入ったとは判断できなかった。
出典: 自社の実測(2026-11-06)
公式はcore.ignoreCaseをどう説明しているか
core.ignoreCaseとは、大文字小文字を区別しないファイルシステムでGitを動作させるための各種回避策を有効にする内部変数のことだ。
Git公式のgit-configには、次の説明がある。
core.ignoreCase Internal variable which enables various workarounds to enable Git to work better on filesystems that are not case sensitive, like APFS, HFS+, FAT, NTFS, etc.
出典: https://git-scm.com/docs/git-config (取得日 2026-11-05)
また、同じ節は初期値とリポジトリ作成時の扱いを次のように説明している。
The default is false, except git-clone[1] or git-init[1] will probe and set core.ignoreCase true if appropriate when the repository is created.
出典: https://git-scm.com/docs/git-config (取得日 2026-11-05)
既定値がfalseという説明だけを読むと、手元のtrueを変更したくなるかもしれない。しかし、公式はcloneやinitが調査し、適切な場合にはtrueを設定すると書いている。今回の実測でも、git init後の値はtrueだった。
さらに公式には、値の変更が予期しない挙動につながる可能性が記されている。したがって、この設定を「大文字小文字だけのリネームを認識させるためのスイッチ」として扱うのは、公式の説明とは異なる。設定の役割と、ファイル名を変更する操作を分けて考える必要がある。
mv・git mv・設定変更の結果を比べる
実測では、通常のmvに続いてgit mvを実行した。さらに別のリポジトリを作り、core.ignorecaseをfalseに変更してからmvする手順を試した。結果を並べると、単に変更が表示されるかどうかだけでなく、記録される名前にも違いがある。
| 操作・設定 | 操作後のgit status --short |
その後のGitの記録 | ディスク上の名前 |
|---|---|---|---|
trueのままmv |
出力なし | Foo.txtのまま |
foo.txt |
続いてgit mv |
R Foo.txt -> foo.txt |
コミット後はfoo.txt |
foo.txt |
falseに変更してmv |
?? foo.txt。git add -A後はA foo.txt |
コミット後はFoo.txtとfoo.txt |
foo.txt |
git mvの場合、実際の記録には名前の変更が表示された。
$ git mv Foo.txt foo.txt
$ git status --short
R Foo.txt -> foo.txt
その後、コミットしてから確認したgit ls-filesはfoo.txtになった。今回の目的である「Gitに記録された名前を変更する」という点では、この手順で結果を確認できた。
一方、falseに変更したケースでは、foo.txtは新しいファイルとして見えた。git add -A後も、表示されたのは名前の変更ではなく追加だ。コミット後にはFoo.txtとfoo.txtの両方が記録され、ディスク上で見える名前はfoo.txtだけだった。
この比較では、git statusに何かが出たことだけを成功の基準にはできない。変更の種類がリネームなのか追加なのか、さらに記録された名前がどうなったのかまでが確認対象になる。
出典: 自社の実測(2026-11-06)
名前の変更にはどちらを使うか――clone先の違いも確認する
今回の環境で大文字小文字だけを変える目的には、名前の変更として記録されたgit mvを選ぶ根拠がある。core.ignorecase=falseへの変更では、目的の名前へ置き換わるのではなく、両方の名前が履歴に入ったためだ。
その履歴をcloneした結果も、保存先によって違った。大文字小文字を区別するAPFSは、hdiutil create -fs 'Case-sensitive APFS'で作成した64MBのディスクイメージで確認している。
| clone先 | 作業ツリーで確認した名前 | git ls-filesの名前 |
衝突の警告 |
|---|---|---|---|
| 大文字小文字を区別するAPFS | Foo.txtとfoo.txt |
Foo.txtとfoo.txt |
記録上なし |
| 大文字小文字を区別しないAPFS | foo.txtのみ |
Foo.txtとfoo.txt |
あり |
大文字小文字を区別しないAPFSへのcloneでは、次の警告が出た。
warning: the following paths have collided (e.g. case-sensitive paths
on a case-insensitive filesystem) and only one from the same
colliding group is in the working tree:
'Foo.txt'
'foo.txt'
ここでは作業ツリーに置かれたファイルは1つだったが、git ls-filesには両方の名前が残った。また、clone後のgit status --shortは空だった。変更表示がない状態でも、clone時の警告と記録されたパスには確認すべき違いがあった。
なお、この測定は同じmacOS上で、大小文字の区別が異なるAPFSを使ったものだ。別のMacでの実行、WindowsやLinuxでの挙動、Gitホスティング側の表示は確認していない。一時的な名前を挟む2段階のgit mvとの比較もしていないため、その方法との差はこの結果からは述べられない。
出典: 自社の実測(2026-11-06)
自分の環境で確かめる手順
手元で確認するなら、Foo.txtをすでにコミットした検証用リポジトリを用意する。以下は名前を変更する操作を含むので、そのファイルを変更してよい場所で実行する。これは読者が確認するための手順であり、ここに手元の環境での出力を示すものではない。
git config core.ignorecase
git ls-files
git mv Foo.txt foo.txt
git status --short
git ls-files
最初に設定値と記録された名前を確認し、git mv後に変更の種類と名前を見比べる。今回の実測ではgit mvが名前の変更として表示され、コミット後の記録もfoo.txtになった。自分の環境でも、ディスク上の表示だけで完了とせず、Gitがどの名前を記録しているかを確認したい。
core.ignorecaseの値を変えて変更表示を出す方法は、今回の測定では両方の名前を記録する結果になった。大小文字だけのリネームを確かめる際は、この設定変更の結果と、git mvで確認できた結果を混同しないことが要点になる。
Git を仕組みから学び直したいとき
Git の仕組みから手を動かして学び直したいときは、『Gitハンズオンラーニング』が使えます。Amazon の商品ページで題名と発売日(2025年2月)を確認しました(取得日 2026-11-14)。この記事の結果は手元で実行した出力によるもので、同書の内容に基づくものではありません。

コメント