---

Gitコマンド深度解説: git diff [ファイル名] を徹底理解する

はじめに

Gitは、現代のソフトウェア開発において不可欠なバージョン管理システムです。その中でも、コードの変更内容を確認する際に最も頻繁に使用されるコマンドの一つが git diff です。git diff コマンドは非常に多機能であり、様々な状況での差分表示に対応していますが、特に特定のファイルに絞って変更を確認したい場合に役立つのが git diff [ファイル名] という形式です。

この記事では、git diff [ファイル名] コマンドに焦点を当て、その基本的な機能から応用、関連コマンドとの比較、そして知っておくと便利なオプションやトラブルシューティングまで、詳細かつ網羅的に解説します。Git初心者からベテランまで、このコマンドの真価を理解し、日々の開発ワークフローをより効率的に、そして自信を持って進めるための知識を提供します。

Gitの基本的な状態とgit diffの関係

git diff [ファイル名] コマンドを理解する上で、Gitがファイルをどのように管理しているか、その基本的な「状態」を把握しておくことが重要です。Gitは主に以下の3つの状態を持つと考えられます。

1. ワーキングツリー (Working Tree / Working Directory):
   これは、あなたのファイルシステム上の実際のディレクトリです。あなたがエディタでファイルを開き、コードを記述したり変更したりするのは、このワーキングツリー内のファイルに対して行われます。git clone でリポジトリをクローンしたり、git checkout でブランチを切り替えたりすると、このワーキングツリーの内容が変化します。ワーキングツリーのファイルは、最後にコミットされた状態やステージングエリアの状態と異なる可能性があります。

2. ステージングエリア (Staging Area / Index):
   「インデックス」とも呼ばれます。これは、次にコミットする変更内容を準備するための場所です。ワーキングツリーで行った変更は、git add コマンドを使ってこのステージングエリアに追加（ステージ）されます。ステージされた変更のみが、次に git commit を実行したときにリポジトリに永続的に記録されるコミットの一部となります。ステージングエリアは、ワーキングツリーとリポジトリ（最後のコミット）の中間に位置する概念です。

3. リポジトリ (Repository):
   これは、プロジェクトのすべてのコミット（スナップショット）が保存されている場所です。コミットは、特定の時点におけるプロジェクトのファイルやディレクトリ構造の完全なスナップショットとして記録されます。リポジトリは通常、プロジェクトディレクトリ内の .git サブディレクトリに格納されています。コミットにはそれぞれ一意のハッシュ値（SHA-1値）が割り当てられ、これによって過去の任意の時点の状態を参照できます。

git diff コマンドは、これら3つの状態のうち、異なる2つの状態間の差分を表示するために使用されます。git diff [ファイル名] という特定の形式では、特にワーキングツリーとステージングエリアの間の差分に焦点を当てます。

git diff [ファイル名] は何を示すのか？

最もシンプルな形式である git diff [ファイル名] （ファイル名だけを指定し、それ以外の引数を省略した場合）は、デフォルトで ワーキングツリーにある指定されたファイルの現在の状態 と、ステージングエリアにある同じファイルのバージョン の間の差分を表示します。

これは、あなたがファイルを編集した後、まだ git add していない変更を確認したい場合に非常に役立ちます。つまり、「これからステージしようとしている変更は何か？」 を個別のファイルごとに確認するためのコマンドと言えます。

デフォルトの比較対象

• 比較対象1: ワーキングツリーのファイル ([ファイル名])
• 比較対象2: ステージングエリア (Index) のファイル ([ファイル名])

このコマンドは、ステージングエリアに登録されていない（git add されていない）変更のみを表示します。もし指定したファイルに対する変更がすべてステージ済みであれば、git diff [ファイル名] は何も表示しません。

なぜ git diff [ファイル名] を使うのか？ 他の git diff との違い

Gitには git diff というコマンドがいくつか異なる形式で存在します。それぞれの形式が比較する対象を理解することで、git diff [ファイル名] がどのような状況で特に有用なのかが明確になります。

1. git diff (引数なし):
   これは ワーキングツリー と ステージングエリア 全体の差分を表示します。つまり、まだ git add していない全ての変更（全ファイルにわたる差分）を表示するコマンドです。

   • 比較対象: ワーキングツリー vs ステージングエリア (全てのファイル)

2. git diff --staged または git diff --cached:
   これは ステージングエリア と 直近のコミット (HEAD) の差分を表示します。つまり、git add したけれど、まだコミットしていない変更を確認するためのコマンドです。

   • 比較対象: ステージングエリア vs HEADコミット (全てのファイル)

3. git diff [ファイル名]:
   これはこの記事の主題です。 ワーキングツリー と ステージングエリア の間の、指定されたファイルのみ の差分を表示します。

   • 比較対象: ワーキングツリーの [ファイル名] vs ステージングエリアの [ファイル名]

4. git diff <commit> <ファイル名>:
   これは ワーキングツリー の指定されたファイルと、指定したコミット 時点の同じファイルの差分を表示します。過去のコミットと現在のワーキングツートの差分を見たい場合に便利です。

   • 比較対象: ワーキングツリーの [ファイル名] vs 時点の [ファイル名]

5. git diff <commit1> <commit2> <ファイル名>:
   これは 時点と 時点の間の、指定されたファイルの差分を表示します。2つの異なるコミット間で、特定のファイルがどのように変化したかを確認できます。

   • 比較対象: 時点の [ファイル名] vs 時点の [ファイル名]

6. git diff <branch1> <branch2> <ファイル名>:
   これは のHEADコミットと のHEADコミットの間で、指定されたファイルがどのように異なるかを表示します。ブランチ間で特定のファイルの違いを確認したい場合に便利です。

   • 比較対象: HEADの [ファイル名] vs HEADの [ファイル名]

このように、git diff には様々な形式がありますが、git diff [ファイル名] は 「まだステージしていない、指定ファイル単体の変更を確認する」 という目的に特化しており、日々のコーディング中に頻繁に使う、非常に粒度の細かい差分確認手段として重宝します。

例えば、複数のファイルを変更している最中に、特定のファイルで何を変更したかをピンポイントで確認したい場合、git diff だと他のファイルの変更も混ざって表示されてしまいます。しかし、git diff [ファイル名] を使うことで、そのファイルの変更だけに注目できるため、レビューや git add の前に変更内容を正確に把握し、意図しない変更が含まれていないかを確認するのに役立ちます。

差分表示の基本フォーマット (Unified Diff Format)

git diff コマンドは、デフォルトで「Unified Diff Format」と呼ばれる標準的な形式で差分を表示します。このフォーマットを理解することは、差分内容を正確に読み取るために不可欠です。

差分表示は通常、以下の要素で構成されます。

1. ヘッダー行:

   • diff --git a/[ファイル名] b/[ファイル名]
     これは、Git diffの開始を示し、比較されているファイルが a/[ファイル名] と b/[ファイル名] であることを示します。a/ は一般的に比較対象の「元の」ファイル、b/ は「変更後の」ファイルを示しますが、git diff [ファイル名] の場合はどちらも同じファイル名で、a/ がステージングエリアのバージョン、b/ がワーキングツリーのバージョンを指します。
   • index <ハッシュ値>..<ハッシュ値> <モード>
     比較対象であるステージングエリアのファイルとワーキングツリーのファイル（正確にはblobオブジェクト）のハッシュ値と、ファイルのモード（パーミッションなど）を示します。
   • --- a/[ファイル名]
     比較対象の「元の」ファイル（ステージングエリアのバージョン）を示します。
   • +++ b/[ファイル名]
     比較対象の「変更後の」ファイル（ワーキングツリーのバージョン）を示します。

2. ハンクヘッダー行:

   • @@ -<行数>,<変更前の行数> +<行数>,<変更後の行数> @@ [<オプション情報>]
     これは「ハンク (hunk)」と呼ばれる変更箇所のまとまりの開始を示します。
     • -<行数>,<変更前の行数>: 「元の」ファイル（ステージングエリア）での変更開始行と、そこから何行が変更に関連しているかを示します。<変更前の行数> が1の場合は省略されることがあります (-<行数>)。
     • +<行数>,<変更後の行数>: 「変更後の」ファイル（ワーキングツリー）での変更開始行と、そこから何行が変更に関連しているかを示します。<変更後の行数> が1の場合は省略されることがあります (+<行数>)。
     • [<オプション情報>]: 多くの場合、変更が含まれる関数名やメソッド名などが表示され、どのコードブロックに変更があるのかを素早く判断できます。

3. 差分内容:
   ハンクヘッダー行の後に、具体的な差分内容が示されます。各行の先頭には以下のいずれかの記号が付きます。

   • (スペース): 変更されていないコンテキスト行です。差分の前後にある、変更されていない行を示し、変更箇所を特定しやすくします。
   • - (マイナス): 「元の」ファイル（ステージングエリア）には存在したが、「変更後の」ファイル（ワーキングツリー）から削除された行です。赤色で表示されることが多いです。
   • + (プラス): 「変更後の」ファイル（ワーキングツリー）には存在するが、「元の」ファイル（ステージングエリア）には存在しなかった行です。緑色で表示されることが多いです。

例

diff
diff --git a/example.txt b/example.txt
index abcdef1..1234567 100644
--- a/example.txt
+++ b/example.txt
@@ -1,3 +1,4 @@
This is the first line.
-This is the second line.
+This is the modified second line.
This is the third line.
+This is a new fourth line.

この例を読み解くと：
* diff --git a/example.txt b/example.txt: example.txt というファイルの差分です。
* --- a/example.txt: ステージングエリアの example.txt です。
* +++ b/example.txt: ワーキングツリーの example.txt です。
* @@ -1,3 +1,4 @@:
* 元のファイル (---) では1行目から3行分がこの差分に関連しています。
* 変更後のファイル (+++) では1行目から4行分がこの差分に関連しています。
* This is the first line.: 変更されていない1行目です。
* -This is the second line.: ステージングエリアにあった2行目が削除されました。
* +This is the modified second line.: ワーキングツリーに、変更された新しい2行目が追加されました。
* This is the third line.: 変更されていない3行目です。
* +This is a new fourth line.: ワーキングツリーに新しい4行目が追加されました。

つまり、この差分は「2行目を変更し、4行目を追加した」という変更を示しています。

実践的な使い方：デモで理解する git diff [ファイル名]

実際にリポジトリを作成し、ファイルを作成・編集して git diff [ファイル名] の挙動を確認してみましょう。

セットアップ

まず、新しいディレクトリを作成し、Gitリポジトリとして初期化します。

bash
mkdir git_diff_demo
cd git_diff_demo
git init

次に、比較の基準となる最初のコミットを作成します。example.txt というファイルを作成し、初期内容を書き込みます。

bash
echo "これは最初の行です。" > example.txt
echo "これは2番目の行です。" >> example.txt
echo "これは3番目の行です。" >> example.txt

このファイルをステージし、コミットします。

bash
git add example.txt
git commit -m "Initial commit with example.txt"

これで、ワーキングツリー、ステージングエリア、そしてリポジトリのHEADが全て同じ状態になりました。

変更1: 既存行の変更（まだステージしていない）

example.txt を開き、2番目の行を変更してみましょう。

“`bash

example.txt をエディタで開いて編集するか、以下のコマンドで置き換える

echo “これは最初の行です。” > example.txt
echo “これは変更された2番目の行です。” >> example.txt # この行を変更
echo “これは3番目の行です。” >> example.txt
“`

この時点で、ワーキングツリーの example.txt は変更されていますが、ステージングエリアの example.txt は前回のコミット時の状態（「これは2番目の行です。」）のままです。

ここで git diff example.txt を実行してみます。

bash
git diff example.txt

出力は以下のようになるはずです（ハッシュ値などは異なります）。

diff
diff --git a/example.txt b/example.txt
index 1234567..abcdef1 100644
--- a/example.txt
+++ b/example.txt
@@ -1,3 +1,3 @@
これは最初の行です。
-これは2番目の行です。
+これは変更された2番目の行です。
これは3番目の行です。

期待通り、ステージングエリア（-が付いた行）とワーキングツリー（+が付いた行）の間の差分が表示されました。他のファイルに変更があっても、git diff example.txt は example.txt 以外の差分は表示しません。

もし、ここで引数なしの git diff を実行した場合も、変更があるのは example.txt だけなので同じ差分が表示されます。しかし、複数のファイルを変更している状況では git diff [ファイル名] の有用性が際立ちます。

変更2: 新しい行の追加（まだステージしていない）

次に、example.txt に新しい行を追加してみましょう。

“`bash

example.txt に新しい行を追加

echo “これは最初の行です。” > example.txt
echo “これは変更された2番目の行です。” >> example.txt
echo “これは3番目の行です。” >> example.txt
echo “これは追加された4番目の行です。” >> example.txt # この行を追加
“`

再度 git diff example.txt を実行します。

bash
git diff example.txt

出力は以下のようになるはずです。

diff
diff --git a/example.txt b/example.txt
index abcdef1..fedcba9 100644
--- a/example.txt
+++ b/example.txt
@@ -1,3 +1,4 @@
これは最初の行です。
これは変更された2番目の行です。
これは3番目の行です。
+これは追加された4番目の行です。

前回の差分（2行目の変更）と、今回の差分（4行目の追加）がまとめて表示されました。これは、git diff [ファイル名] が「ワーキングツリーとステージングエリアの現在の状態」の差分を表示するからです。前回の git diff 時点からワーキングツリーはさらに変更されています。

変更をステージする

ここで、現在の変更をステージしてみましょう。

bash
git add example.txt

これで、ワーキングツリーで行った変更がステージングエリアに移動しました。つまり、ワーキングツリーとステージングエリアの example.txt の内容は全く同じになりました。

この状態で git diff example.txt を実行するとどうなるでしょうか？

bash
git diff example.txt

何も表示されません。

これは、git diff [ファイル名] が「ワーキングツリー vs ステージングエリア」の差分を表示するからです。git add example.txt を実行した結果、両者の内容が一致したため、差分が存在しないと判断され、何も表示されないのです。

では、ステージした変更を確認するにはどうすればよいでしょうか？ その場合は git diff --staged example.txt を使用します。

bash
git diff --staged example.txt

このコマンドは「ステージングエリア vs HEADコミット」の差分を表示するため、以下のような出力が得られます。

diff
diff --git a/example.txt b/example.txt
index 1234567..fedcba9 100644
--- a/example.txt
+++ b/example.txt
@@ -1,3 +1,4 @@
これは最初の行です。
-これは2番目の行です。
+これは変更された2番目の行です。
これは3番目の行です。
+これは追加された4番目の行です。

これは、最初のコミット時の内容（HEAD）と、現在ステージングエリアにある内容との差分です。

この一連のデモから、git diff [ファイル名] が特に まだステージしていない、ワーキングツリーでの変更 を確認するのに特化したコマンドであることが理解できたかと思います。

git diff [ファイル名] で利用できる便利なオプション

git diff [ファイル名] は、他の git diff コマンドと同様に、表示形式や比較方法をカスタマイズするための多くのオプションをサポートしています。その中でも、指定ファイルに対する差分を確認する際によく使われる、あるいは有用なオプションをいくつか紹介します。

1. --color および --no-color

差分はデフォルトで色付きで表示されますが、環境によっては色が表示されない、または意図しない色になる場合があります。
* git diff example.txt --color: 強制的に色付き表示にします。
* git diff example.txt --no-color: 色なし（プレーンテキスト）で表示します。

通常、Gitはターミナルが色をサポートしているかを自動的に判断しますが、明示的に指定したい場合にこれらのオプションを使用します。

2. --unified=<n>

差分のコンテキスト行数（変更箇所の前後にある、変更されていない行）を制御します。デフォルトでは通常3行が表示されます。
* git diff example.txt --unified=1: コンテキスト行数を1行にします。

変更箇所だけをコンパクトに見たい場合や、逆に広範囲のコードを見て変更の影響を理解したい場合に調整します。

3. --word-diff

行単位の差分ではなく、単語単位（または空白で区切られたまとまり単位）の差分を表示します。テキストファイルや設定ファイルの変更など、行全体が変更されるのではなく、行内の一部分だけが頻繁に変更されるような場合に非常に役立ちます。
* git diff example.txt --word-diff: 単語単位の差分を表示します。削除された単語は [-削除された単語-]、追加された単語は {+追加された単語+} のように表示されます。

例:
元の行: これは変更される行です。
変更後の行: これは一部変更された行です。

git diff --word-diff の出力:
これは[-変更される-]{+一部変更された+}行です。

この形式は、行の内容が大幅に変更された場合に、どこが具体的に変わったのかを一目で把握するのに優れています。

--word-diff にはいくつかのサブオプションもあります。
* --word-diff=color: 単語差分を色で表示します（デフォルト）。
* --word-diff=plain: 単語差分を [-...] と {+...} で囲んで表示します。
* --word-diff=porcelain: スクリプトで解析しやすい特別な形式で単語差分を出力します。

4. --stat

具体的な差分内容ではなく、指定されたファイルにおける変更の概要（追加/削除された行数など）を表示します。大規模なファイルの差分を見る前に、どのくらいの変更があったかを把握したい場合に便利です。
* git diff example.txt --stat: 変更されたファイルのリストと、それぞれのファイルでの追加・削除行数の合計を表示します。

出力例:
example.txt | 2 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
これは example.txt で合計4行の変更があり、その内訳が2行の追加と2行の削除であることを示しています。

5. --name-only

差分のある指定ファイルの名前だけを表示します。git diff (引数なし) や git diff --staged と組み合わせて、変更があるファイルの名前だけをリストアップするのによく使われますが、git diff [ファイル名] と組み合わせても（指定したファイルの名前しか表示しませんが）、後述する他の比較対象との差分を見る際に特定のファイルリストに対して繰り返し実行する場合などに役立つことがあります。
* git diff example.txt --name-only: example.txt と表示します。

6. --binary

テキストファイルではなく、バイナリファイル（画像、実行ファイルなど）の差分を表示する場合に明示的に指定します。デフォルトでは、Gitはバイナリファイルの内容の差分を人間が読める形式で表示することはせず、「Binary files a/path/to/file and b/path/to/file differ」のようなメッセージを表示します。--binary を指定すると、バイナリファイルの差分を特別な形式（base85 エンコードなど）で表示しようとしますが、これは通常、機械的な処理向けであり、人間が直接読んで理解するのは困難です。
* git diff image.png --binary: バイナリファイルの差分を表示（通常は読みにくい形式）。

ほとんどの場合、バイナリファイルの差分確認には git diff をそのまま実行し、変更があったことだけを確認すれば十分です。

7. --ignore-whitespace, --ignore-space-at-eol, --ignore-all-space, --ignore-blank-lines

これらのオプションは、空白文字の変更を無視して差分を表示します。
* --ignore-whitespace: 行末の空白、行頭・行末の空白、連続する空白の数の変更を無視します。行内の単語間の空白の数が増減した場合は差分として検出されます。
* --ignore-space-at-eol: 行末の空白のみを無視します。
* --ignore-all-space: 行頭、行末、行内の連続する空白の数、そして行の追加・削除による空白行の変更など、あらゆる空白文字の変更を無視します。コードの実質的な変更（非空白文字の変更）のみを確認したい場合に最も強力なオプションです。
* --ignore-blank-lines: 空白行の追加・削除のみを無視します。

これらのオプションは、共同開発でエディタの設定やOSの違い（特にWindowsとUnix系）によるインデントや行末の空白の問題に遭遇した場合に、本質的なコードの変更だけを確認するのに非常に役立ちます。

例:
bash
git diff example.txt --ignore-all-space
このコマンドは、example.txt の内容で、空白のみが変更された部分は差分として表示しません。

git diff [ファイル名] の高度な使い方・応用

git diff [ファイル名] の基本的な動作は「ワーキングツリー vs ステージングエリア」ですが、特定のファイルに絞って、他の比較対象との差分を見ることも可能です。これは、特定のファイルについて、過去の履歴や他のブランチの状態と比較したい場合に非常に役立ちます。

これらの高度な使い方は、基本的に git diff <比較対象1> <比較対象2> [ファイル名] という形式をとりますが、特定のファイル名を指定することで、そのファイル以外の差分は無視される点がポイントです。

1. 特定のコミットとの差分

特定のコミット時点のファイルと、ワーキングツリーまたはステージングエリアのファイルを比較できます。

• 特定のコミット vs ワーキングツリー:
  git diff <commit> [ファイル名]
  または git diff <commit>.. [ファイル名]
  例: git diff HEAD~1 example.txt (HEADの1つ前のコミットとワーキングツリーのexample.txtを比較)
  例: git diff abcdef1.. example.txt (ハッシュ値abcdef1のコミットとワーキングツリーのexample.txtを比較)

• 特定のコミット vs ステージングエリア:
  git diff --staged <commit> [ファイル名]
  または git diff <commit> :0:[ファイル名]
  例: git diff --staged HEAD~1 example.txt (HEADの1つ前のコミットとステージングエリアのexample.txtを比較)
  (:0: はステージングエリアを示すGitの内部的な参照です)

• 特定のコミット vs HEADコミット:
  git diff <commit> HEAD [ファイル名]
  例: git diff HEAD~5 HEAD example.txt (5つ前のコミットと現在のHEADコミットのexample.txtを比較)
  これは、特定のファイルが過去5回のコミットの間でどのように変化したかを確認したい場合に便利です。

2. 異なるブランチとの差分

他のブランチのHEADコミット時点のファイルと、現在のブランチのワーキングツリーやステージングエリア、またはHEADコミットのファイルを比較できます。

• 他のブランチ vs ワーキングツリー:
  git diff <branch> [ファイル名]
  または git diff <branch>.. [ファイル名]
  例: git diff feature/my-feature example.txt (feature/my-featureブランチのHEADと現在のワーキングツリーのexample.txtを比較)

• 他のブランチ vs 現在のHEADコミット:
  git diff <branch> HEAD [ファイル名]
  例: git diff main HEAD example.txt (mainブランチのHEADと現在のブランチのHEADのexample.txtを比較)
  これは、マージする前に特定のファイルがどのように異なるかを確認するのに役立ちます。

3. 特定の比較対象を指定した差分 (Tree-ish)

Gitでは、コミットハッシュ、ブランチ名、タグ名、HEADなどの特定の時点や参照を「Tree-ish」と呼びます。git diff はこれらのTree-ishを比較対象として指定できます。

• ワーキングツリー vs HEADコミット:
  git diff HEAD [ファイル名]
  これは、直近のコミット以降に行った、まだステージしていない変更とステージした変更の両方（つまりワーキングツリー全体の変更）を特定のファイルについて表示します。git diff [ファイル名] とは異なり、こちらはHEADコミットとの比較です。
  例: git diff HEAD example.txt

• ステージングエリア vs HEADコミット:
  git diff --staged HEAD [ファイル名]
  または git diff :1:[ファイル名] :0:[ファイル名]
  これは、ステージングエリアの変更を特定のファイルについて表示します。git diff --staged example.txt と同じです。

• ワーキングツリー vs 特定のステージ:
  Gitのステージングエリアは内部的に3つの「ステージ」を持ちます（通常はステージ0のみが使われます）。コンフリクト発生時には、ステージ1 (共通の祖先), ステージ2 (現在のブランチ), ステージ3 (マージ相手のブランチ) が使われます。
  git diff :1:[ファイル名] :0:[ファイル名] のように、特定のステージを指定して差分を確認することも可能です。これはマージコンフリクトの解消時に特定のファイルのコンフリクト状態を確認するのに役立ちます。
  例: git diff :1:conflicted_file.txt :2:conflicted_file.txt (コンフリクトファイルについて、共通の祖先と現在のブランチの差分を確認)

4. 複数のファイルをまとめて指定

複数のファイルをまとめて差分表示したい場合は、ファイル名をスペースで区切って複数指定できます。
* git diff file1.txt file2.txt file3.txt

これは、指定したファイル全ての「ワーキングツリー vs ステージングエリア」の差分をまとめて表示します。

5. ディレクトリを指定

ファイルを指定する代わりに、ディレクトリを指定することも可能です。
* git diff <directory>

これは、指定したディレクトリ以下の全てのファイルについて、「ワーキングツリー vs ステージングエリア」の差分を表示します。これは引数なしの git diff を特定のサブディレクトリに限定したような動作になります。

6. 出力をファイルに保存または他のコマンドに渡す

差分結果をファイルに保存したり、grepなどの他のコマンドに渡して処理したい場合があります。

• ファイルに保存:
  git diff example.txt > example_diff.patch
  このようにリダイレクトすることで、差分結果を example_diff.patch というファイルに保存できます。.patch ファイルは git apply コマンドなどで適用可能です。

• 他のコマンドにパイプ:
  git diff example.txt | grep "特定のキーワード"
  差分出力の中から特定のキーワードを含む行だけを抽出したい場合などに利用できます。

よくある問題とトラブルシューティング

git diff [ファイル名] を使用する際に遭遇する可能性のある問題と、その対処法について説明します。

1. git diff [ファイル名] を実行しても何も表示されない

これは最も一般的で、多くの場合は意図された挙動です。以下の可能性が考えられます。

• 指定したファイルに、まだステージしていない変更がない: git diff [ファイル名] はワーキングツリーとステージングエリアの差分を表示します。もしあなたがファイルに変更を加えた後、その変更を git add してしまった場合、ワーキングツリーとステージングエリアの内容は一致しているため、差分は表示されません。
  • 確認方法: git status を実行してみてください。もしファイル名が “Changes to be committed:” のセクションに表示されているなら、変更はステージ済みです。この場合、git diff --staged [ファイル名] で差分を確認できます。もし “Changes not staged for commit:” のセクションにも表示されていないなら、そのファイルには変更がないか、変更を破棄してしまった可能性があります。
• 指定したファイル名が間違っている: ファイル名の大文字・小文字やパスが正確でない場合、Gitはファイルを見つけられず、結果として何も表示しないか、エラーメッセージを表示します。
  • 確認方法: ls コマンドなどで正確なファイル名とパスを確認してください。
• ファイルの変更がGitに認識されない特殊な変更である: 例えば、ファイルのパーミッションだけを変更した場合など、Gitの標準的な差分表示で捉えられない種類の変更もあります。
  • 確認方法: git status でファイルが変更されたと認識されているか確認してください。パーミッションの変更は git status で表示されることがあります。

2. 予期しない差分が表示される、または期待した差分が表示されない

• 行末コードの違い (CRLF vs LF): Windows環境とUnix/macOS環境では、改行コードが異なる（CRLF vs LF）。共同開発でOSが混在している場合、Gitの設定によっては、改行コードだけの違いが差分として表示されることがあります。
  • 対処法: Gitの core.autocrlf 設定を確認・調整します。
    • git config core.autocrlf: 現在の設定を確認。
    • git config --global core.autocrlf true: Windowsユーザー推奨（チェックアウト時にCRLF、コミット時にLFに変換）。
    • git config --global core.autocrlf input: Unix/macOSユーザー推奨（コミット時にLFに変換、チェックアウト時はそのまま）。
    • git config --global core.autocrlf false: 非推奨。
  • 一時的に改行コードの差分を無視したい場合は、差分表示時に --ignore-cr-at-eol オプションを使用することもできます（ただし、これは通常使用しない方が良いでしょう）。
• 空白文字の変更: 行頭、行末、または行内の空白文字（スペース、タブ）の増減や種類（スペースとタブの混在）が差分として表示されることがあります。
  • 対処法: 前述の --ignore-whitespace, --ignore-space-at-eol, --ignore-all-space オプションを使用して、空白文字の変更を無視して差分を表示します。--ignore-all-space が最も強力です。
• ファイルのエンコーディング: ファイルのエンコーディングが予期せず変更された場合、Gitのdiffが正しく機能しない、または文字化けした差分が表示されることがあります。
  • 対処法: ファイルのエンコーディングを確認し、プロジェクト内で統一されたエンコーディング（通常はUTF-8）を使用するようにします。Gitの core.quotepath 設定やターミナルの設定も影響する場合があります。
• 意図せずファイルがバイナリファイルとして扱われている: テキストファイルなのにバイナリファイルとして扱われ、「Binary files … differ」と表示される場合があります。
  • 対処法: .gitattributes ファイルを使用して、特定の拡張子のファイルをテキストとして扱うように明示的に指定します。例: *.csv text

3. 差分表示が長すぎる、ターミナルに収まらない

• Gitのdiff出力は通常、ページャー（lessコマンドなど）にパイプされて表示されます。これにより、長い出力でも画面に収まるようにスクロールして確認できます。もしページャーが有効になっていない場合は、以下の設定を確認してください。
  • git config core.pager: 現在のページャー設定を確認。
  • git config --global core.pager less -FRSX: lessをページャーとして設定する一般的な方法（less -FRSX は、画面に収まる場合はページングしない、長い行を折り返さないなどのオプション）。
  • または、差分出力をファイルにリダイレクトして、エディタで確認します (git diff example.txt > diff.patch)。

git diff [ファイル名] をワークフローに組み込む

git diff [ファイル名] は、開発サイクルの中で非常に早い段階で使用されるコマンドです。

1. 編集: コードエディタでファイルを変更します。
2. 確認: git diff [ファイル名] を実行して、加えた変更が意図した通りか、余計な変更（デバッグ出力など）が含まれていないかを確認します。複数のファイルを変更している場合でも、ファイル単位で確認できるため、集中的にレビューできます。
3. 追加: 確認した変更を git add [ファイル名] でステージングエリアに追加します。
4. 最終確認（ステージング）: git diff --staged [ファイル名] または git diff --staged を実行して、コミットする準備ができた変更を確認します。ここで git diff [ファイル名] を実行しても何も表示されないことを確認することで、「ワーキングツリーにはもうステージすべき変更はない」という状態を保証できます。
5. コミット: git commit -m "適切なメッセージ" で変更をリポジトリに記録します。

このサイクルにおいて、git diff [ファイル名] は「まだステージしていない変更の確認」という重要な役割を担います。git add の前に、各ファイルの変更内容を正確に把握することで、意図しない変更をコミットしてしまうミスを防ぎ、よりクリーンで管理しやすいコミット履歴を作成する手助けとなります。

まとめ

この記事では、git diff [ファイル名] コマンドについて、その基本的な機能から詳細な使い方、関連コマンドとの比較、便利なオプション、そしてトラブルシューティングまでを網羅的に解説しました。

• git diff [ファイル名] は、ワーキングツリーにある指定ファイルの現在の状態と、ステージングエリアにある同じファイルのバージョンの差分を表示するコマンドです。
• その主な用途は、まだ git add していない、指定ファイル単体の変更を確認する ことです。
• Unified Diff Formatを理解することで、差分表示の内容を正確に読み取ることができます。
• --word-diff, --stat, --ignore-all-space などのオプションを使用することで、差分表示形式を調整したり、特定の種類の変更（空白文字など）を無視したりできます。
• ファイル名を指定する形式でも、コミットハッシュ、ブランチ名などのTree-ishを指定することで、特定のファイルについて過去の履歴や他のブランチとの差分を確認する応用的な使い方が可能です（例: git diff <commit> [ファイル名]）。
• 何も表示されない場合や予期しない差分が表示される場合は、Gitの基本的な状態、ファイル名、改行コード、空白文字、エンコーディングなどを確認し、適切なオプション（--staged, --ignore-all-space など）を試してみてください。
• 日々の開発ワークフローにおいて、git add の前に git diff [ファイル名] で変更内容を確認する習慣をつけることで、より正確で安全なバージョン管理を行うことができます。

git diff [ファイル名] はシンプルながらも非常に強力なツールです。このコマンドを使いこなすことで、あなたのGitを使った開発効率は格段に向上するでしょう。ぜひ、この記事で学んだ知識を活かして、実際に手を動かしながらコマンドの感覚を掴んでください。

結論

Gitの差分表示機能は、コードの変更を理解し、管理するための基盤です。特に git diff [ファイル名] は、多忙な開発プロセスの中で特定のファイルに集中し、行った変更を正確に把握するための不可欠なツールと言えます。ワーキングツリーの状態を常に意識し、ステージングエリアとの差分である git diff [ファイル名] を適切に活用することで、コミット内容の質を高め、履歴をより明確に保つことができます。

Gitの学習は、一つ一つのコマンドの役割と、それらが組み合わさることでどのようなワークフローが生まれるのかを理解する過程です。この記事が、あなたが git diff [ファイル名] を深く理解し、Gitをさらに効果的に使いこなすための一助となれば幸いです。バージョン管理の旅は続きます。常に新しい発見と学びがあるこの道を、 confidently (自信を持って) 進んでいきましょう。

---