git diffで、作業中・ステージ・コミットの差分を見比べる方法

​​Git​コマンドライン

コミットする前に「どこを変えたか」を確かめるときは、git diff に何を付けるかで、比べる相手が変わります。オプションなしの git diff は、まだ git add していない変更だけを出します。git add したあとの変更は git diff --staged、最後のコミットからの変更をまとめて見るなら git diff HEAD です。「git add したら git diff に何も出なくなった」というときも、この違いで説明できます。操作の前後の出力を、検証環境で並べて確かめました。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定し、コミットの日時は環境変数 GIT_AUTHOR_DATE と GIT_COMMITTER_DATE で決めました。出力はページャーを通さずにファイルへ書き出したので、色は付いていません。Windows・macOS、外部の差分ツール(git difftool)は試していません。

3つの場所と、git diff の比べる相手

ファイルの内容は、最新のコミット(HEAD)、git add した内容が入るステージ(インデックス)、手元で編集している作業ツリーの3か所にあります。git diff は、このうち2か所を比べます。

最新のコミット、ステージ、作業ツリーの3つの箱。git diff は作業ツリーとステージ、git diff --staged はステージと HEAD、git diff HEAD は作業ツリーと HEAD を比べる
git diff の書き方と、比べる2か所の対応

git diff の公式リファレンスでは、オプションなしの git diff は、ステージ(次のコミットに入れる内容を置いておく場所)と比べて、手元でどこを変えたかを見るものと説明されています。--cached はステージした変更をコミットと比べる書き方で、コミットを省くと HEAD と比べます。--staged は --cached の別名です。git diff HEAD のようにコミットを1つ渡すと、作業ツリーとそのコミットを比べます。

以下は、price.txt と news.txt があるリポジトリで試しました。最後のコミットでは、price.txt の手数料は200円です。

console
$ git log --oneline
a8d5608 送料を400円に変更
18a95a1 最初のコミット

何も変えていないときは、git diff も git diff --staged も何も出しません。

まだ add していない変更を見る

手数料を100円に書き換えます。git diff には変更が出て、git diff --staged には何も出ません。まだステージに入っていないからです。

console
$ sed -i "s/手数料: 200円/手数料: 100円/" price.txt

$ git diff
diff --git a/price.txt b/price.txt
index ea0fb19..fbe82df 100644
--- a/price.txt
+++ b/price.txt
@@ -1,2 +1,2 @@
 送料: 400円
-手数料: 200円
+手数料: 100円

$ git diff --staged

- で始まる行が比べる元(ここではステージ)にあった行、+ で始まる行が新しい側(作業ツリー)の行です。先頭が空白の行は、変わっていない前後の行です。

git add したあとは –staged で見る

同じ変更を git add すると、出る場所が入れ替わります。git diff は空になり、git diff --staged に変更が出ました。

console
$ git add price.txt

$ git diff

$ git diff --staged
diff --git a/price.txt b/price.txt
index ea0fb19..fbe82df 100644
--- a/price.txt
+++ b/price.txt
@@ -1,2 +1,2 @@
 送料: 400円
-手数料: 200円
+手数料: 100円

git add しても変更は消えていません。作業ツリーとステージが同じ内容になったので、オプションなしの git diff で比べる2か所の間に差がなくなっただけです。git diff --cached でも、同じ出力になりました。コミットする直前に「このコミットに何が入るか」を確かめるには、git diff --staged を使います。

add したあとに、さらに書き換えたとき

git add したあとで、手数料をさらに50円に書き換えた場面です。git status --short で MM と出ます。左の M はステージにある変更、右の M は作業ツリーにだけある変更です。

console
$ sed -i "s/手数料: 100円/手数料: 50円/" price.txt

$ git status --short
MM price.txt

ここで3つの書き方を並べると、それぞれ別の2か所を比べていることが分かります。

console
$ git diff
diff --git a/price.txt b/price.txt
index fbe82df..a94015d 100644
--- a/price.txt
+++ b/price.txt
@@ -1,2 +1,2 @@
 送料: 400円
-手数料: 100円
+手数料: 50円

$ git diff --staged
diff --git a/price.txt b/price.txt
index ea0fb19..fbe82df 100644
--- a/price.txt
+++ b/price.txt
@@ -1,2 +1,2 @@
 送料: 400円
-手数料: 200円
+手数料: 100円

$ git diff HEAD
diff --git a/price.txt b/price.txt
index ea0fb19..a94015d 100644
--- a/price.txt
+++ b/price.txt
@@ -1,2 +1,2 @@
 送料: 400円
-手数料: 200円
+手数料: 50円

git diff は「add した100円」から「手元の50円」への変更、git diff --staged は「コミットの200円」から「add した100円」への変更です。git diff HEAD は途中のステージを飛ばして、200円から50円への変更を出しました。

ポイント

git commit の公式リファレンスによると、git commit はステージの今の内容でコミットを作ります。このまま git commit すると、入るのは git diff --staged に出た100円の変更です。手元の50円の変更まで入れたいときは、もう一度 git add します。

新しいファイルは、add するまで git diff に出ない

新しく作った memo.txt は、git status --short では ?? と出ます。git status の公式リファレンスによると、?? は Git がまだ管理していないファイルを表します。このファイルは、git diff にも git diff HEAD にも出ませんでした。

console
$ printf "メモ\n" > memo.txt

$ git status --short
MM price.txt
?? memo.txt

$ git diff HEAD
diff --git a/price.txt b/price.txt
index ea0fb19..a94015d 100644
--- a/price.txt
+++ b/price.txt
@@ -1,2 +1,2 @@
 送料: 400円
-手数料: 200円
+手数料: 50円

git add すると、git diff --staged に new file mode 付きで出ます。比べる元がないので、--- /dev/null と表示されます。

console
$ git add memo.txt

$ git diff --staged -- memo.txt
diff --git a/memo.txt b/memo.txt
new file mode 100644
index 0000000..3a4f957
--- /dev/null
+++ b/memo.txt
@@ -0,0 +1 @@
+メモ

この例のように、ファイル名を -- のあとに書くと、そのファイルの差分だけを出せます。

変わったファイルの一覧だけを見る

変更が多いときは、中身の前にファイルの一覧を見ると全体がつかめます。--stat はファイルごとの増減の行数を、--name-status はファイル名と変更の種類を出します(A は追加、M は変更。文字の意味は、git diff の公式リファレンスの --diff-filter の項にあります)。

console
$ git diff --staged --stat
 memo.txt  | 1 +
 price.txt | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

$ git diff --staged --name-status
A	memo.txt
M	price.txt

コミットどうしを比べる

コミットを2つ渡すと、そのコミットどうしを比べます。手元の50円の変更は git restore price.txt で捨て、add した100円の変更と memo.txt をコミットしてから試しました。

console
$ git log --oneline
98a6a91 手数料を変更してメモを追加
a8d5608 送料を400円に変更
18a95a1 最初のコミット

$ git diff HEAD~1 HEAD
diff --git a/memo.txt b/memo.txt
new file mode 100644
index 0000000..3a4f957
--- /dev/null
+++ b/memo.txt
@@ -0,0 +1 @@
+メモ
diff --git a/price.txt b/price.txt
index ea0fb19..fbe82df 100644
--- a/price.txt
+++ b/price.txt
@@ -1,2 +1,2 @@
 送料: 400円
-手数料: 200円
+手数料: 100円

HEAD~1 は最新のコミットの1つ前です(リビジョンの指定方法を説明した公式リファレンス)。2つ以上離れたコミットも比べられます。HEAD~2 から HEAD までを --stat で見ると、price.txt は2行削除・2行追加(4 ++--)と出ました。この2つのコミットで、送料と手数料を1回ずつ変えたためです。

console
$ git diff HEAD~2 HEAD --stat
 memo.txt  | 1 +
 price.txt | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

git diff HEAD HEAD~1 -- price.txt のように渡す順番を逆にすると、- と + が入れ替わり、100円から200円に戻す変更として表示されました。

ブランチを比べるときの .. と …

feature ブランチを作って定休日を追加し、そのあと main でも送料を300円に変えました。2つのブランチが分かれた状態です。

console
$ git log --oneline --graph --all
* fb81254 送料を300円に変更
| * 71322d1 定休日を追加
|/  
* 98a6a91 手数料を変更してメモを追加
* a8d5608 送料を400円に変更
* 18a95a1 最初のコミット

ドット2つの git diff main..feature は、main の先端と feature の先端をそのまま比べます。feature では何もしていない送料も、300円から400円への変更として出ました。main だけで変えた分が、逆向きに混ざっているわけです。git diff main feature と書いても、同じ出力になりました。

console
$ git diff main..feature
diff --git a/news.txt b/news.txt
index a91b5d8..0cdc76f 100644
--- a/news.txt
+++ b/news.txt
@@ -1 +1,2 @@
 営業時間: 10時から18時
+定休日: 水曜日
diff --git a/price.txt b/price.txt
index c8be634..fbe82df 100644
--- a/price.txt
+++ b/price.txt
@@ -1,2 +1,2 @@
-送料: 300円
+送料: 400円
 手数料: 100円

ドット3つの git diff main...feature は、2つのブランチが分かれた地点と feature の先端を比べます。出たのは、feature で加えた定休日の行だけでした。

console
$ git diff main...feature
diff --git a/news.txt b/news.txt
index a91b5d8..0cdc76f 100644
--- a/news.txt
+++ b/news.txt
@@ -1 +1,2 @@
 営業時間: 10時から18時
+定休日: 水曜日
分かれた地点から main の先端と feature の先端に枝分かれした図。main..feature は2つの先端を比べ、main...feature は分かれた地点と feature の先端を比べる
ドット2つとドット3つで、比べる相手がどう違うか

公式リファレンスによると、git diff A...B は git diff $(git merge-base A B) B と同じです。git merge-base は分かれた地点のコミットを出すコマンドで、検証環境でも、この書き方で main...feature と同じ出力になりました。ブランチで自分が何を変えたかだけを見たいときは、ドット3つを使います。

console
$ git merge-base main feature
98a6a91078591289da46cc19ffaae34dc5e007c8

git log での .. と ... の意味に慣れていると、取り違えやすいところです。公式リファレンスには、git diff は2つの端点を比べるもので、.. や ... は git log などで使う範囲の意味にはならない、と書かれています。

1行の中で変わった文字だけを見る

1行の中の数文字だけを変えても、git diff は行全体を - と + で出します。--word-diff を付けると、変わった部分を [-消えた部分-]{+加わった部分+} の形で1行に並べます。

console
$ sed -i "s/営業時間: 10時から18時/営業時間: 10時から19時/" news.txt

$ git diff --word-diff
diff --git a/news.txt b/news.txt
index a91b5d8..8853e8b 100644
--- a/news.txt
+++ b/news.txt
@@ -1 +1 @@
営業時間: [-10時から18時-]{+10時から19時+}

--word-diff は空白で単語を区切ります。日本語は単語の間に空白を入れないので、10時から18時 がひとかたまりのまま出ました。--word-diff-regex=. で1文字ずつを単語とみなすと、変わった 8 と 9 だけが示されました。

console
$ git diff --word-diff-regex=.
diff --git a/news.txt b/news.txt
index a91b5d8..8853e8b 100644
--- a/news.txt
+++ b/news.txt
@@ -1 +1 @@
営業時間: 10時から1[-8-]{+9+}時

--word-diff-regex は、何を単語とみなすかを正規表現で決めるオプションで、付けると --word-diff も有効になります(git diff の公式リファレンス)。

差分があるかどうかだけを調べる

シェルスクリプトで「まだ add していない変更が残っているか」を調べたいときは、--quiet を使います。何も表示せず、差分がなければ終了コード0、あれば1で終わります。

console
$ git diff --quiet; echo "終了コード: $?"
終了コード: 0

$ printf "x\n" >> news.txt; git diff --quiet; echo "終了コード: $?"
終了コード: 1

--quiet を付けると --exit-code も有効になります。--exit-code は、差分があれば1、なければ0で終わるオプションです(git diff の公式リファレンス)。

​Posted by 86