【Git】addしたファイルの変更を確認する方法｜diff –cached/–stagedとstat・word-diff活用の完全ガイド

# add済みの全変更をdiff表示
git diff --cached

# --staged は完全同義のエイリアス
git diff --staged

# 特定のファイルだけ
git diff --cached src/auth.py

# 複数ファイル
git diff --cached src/auth.py src/utils.py

# ディレクトリ配下
git diff --cached src/

diff --git a/src/auth.py b/src/auth.py
index 70a633d..7972012 100644
--- a/src/auth.py    ← 変更前（index ≒ HEAD側）
+++ b/src/auth.py    ← 変更後（作業ツリー側）
@@ -10,6 +10,7 @@     ← 変更箇所の行範囲（ハンクヘッダ）
 def authenticate(user):
     token = generate_token(user)
-    return token
+    logger.info(f"auth ok: {user.id}")
+    return {"token": token, "expires": 3600}

# addされたファイル名だけをリスト
git diff --cached --name-only
# 出力例:
# src/auth.py
# src/utils.py

# 変更種別（A=追加/M=変更/D=削除/R=rename）付き
git diff --cached --name-status
# 出力例:
# M	src/auth.py
# A	src/new_feature.py
# D	src/obsolete.py

# ファイル別の変更行数を表示
git diff --cached --stat
# 出力例:
#  src/auth.py  | 10 +++++++---
#  src/utils.py |  5 ++++-
#  2 files changed, 12 insertions(+), 3 deletions(-)

# サマリー行だけ
git diff --cached --shortstat
# 出力例:
#  2 files changed, 12 insertions(+), 3 deletions(-)

# ファイル種別変更などのサマリー
git diff --cached --summary

# 単語単位の差分（日本語でもスペース区切りなら動く）
git diff --cached --word-diff

# 表示色を付ける
git diff --cached --word-diff=color

# マークダウン・コード以外の自然言語文書に便利

# 末尾空白を無視
git diff --cached --ignore-space-at-eol

# 空白の量を無視
git diff --cached -w
git diff --cached --ignore-all-space

# 空行追加/削除を無視
git diff --cached --ignore-blank-lines

# 改行コード変更（CRLF/LF）を無視
git diff --cached --ignore-cr-at-eol

# 前後10行ずつ表示（既定は3行）
git diff --cached -U10

# 文脈なしで変更行のみ
git diff --cached -U0

# index にある状態の file をそのまま出力
git show :src/auth.py
# :0 は「index」「ステージ0」を指す（通常のstaged）
git show :0:src/auth.py

# HEAD と index と作業ツリーの3者を同時比較
git diff HEAD -- src/auth.py            # HEAD ↔ 作業ツリー
git diff --cached -- src/auth.py        # HEAD ↔ index
git diff -- src/auth.py                 # index ↔ 作業ツリー

# indexのファイル一覧（パーミッションやハッシュ付き）
git ls-files --stage src/

# デフォルトのdifftoolを起動（要設定）
git difftool --cached

# 特定ツールを指定（VS Code例）
git difftool --cached --tool=vscode

# tool設定例（~/.gitconfigに追記）
# [diff]
#   tool = vscode
# [difftool "vscode"]
#   cmd = code --wait --diff $LOCAL $REMOTE

# まずファイル数・規模を俯瞰
git diff --cached --stat

# 次に各ファイルの内容を精読
git diff --cached

# ファイル別に確認したい場合
git diff --cached src/auth.py

# 問題なければコミット
git commit -m "feat: トークン発行時にログ出力を追加"

# 変更ファイルを一覧
git diff --cached --name-status

# 個別に精査しつつ、不要なファイルをunstage
git restore --staged src/debug.log
git restore --staged tmp/

# 残ったものが本当に意図通りか最終確認
git diff --cached

# 新規ファイルはdiffでは「全行が+」で表示される
git diff --cached src/new_feature.py

# ただし大きい新規ファイルではscrollが大変なので、
# indexの中身を丸ごと表示する方が見やすい場合がある
git show :src/new_feature.py | less

# ファイル数だけ知りたい場合
git diff --cached --stat --name-only | wc -l

# 空白系を無視した本質的な差分
git diff --cached -w

# もし -w で差分が消えるなら「空白だけの変更」しかない
# 意図した変更なら問題ないが、エディタ設定で無駄な空白を入れた可能性も

# 行末空白・タブ混入のチェック
git diff --cached --check
# 出力例:
# src/auth.py:15: trailing whitespace.

# 通常はバイナリとして扱われ、「Binary files differ」と表示
git diff --cached assets/logo.png
# → Binary files a/assets/logo.png and b/assets/logo.png differ

# テキスト扱いを強制（壊れた出力になる可能性あり）
git diff --cached --text assets/logo.png

# バイナリ用にdiff driverを登録する（.gitattributes）
# *.png diff=exif
# → EXIF情報の差分を表示

# ページャーにlessを使って段階表示（デフォルト）
git diff --cached
# → lessが起動、qで終了・/で検索

# ページャーなしで一気に流す
git --no-pager diff --cached

# ファイルに書き出してエディタで確認
git diff --cached > /tmp/staged.patch
code /tmp/staged.patch