歴史を読む — git log と git show

git log と --oneline・-N

1. この回の歴史です。main には5つのコミットがあり、feature は「パンを追加」から分かれて「ジャムを追加」を1つ持っています。HEAD は main に乗っています。

2. 何も付けない git log です。新しいコミットから順に、commit の後ろに ID、その下にメッセージが並びます。1つのコミットに何行も使うので、長い歴史では読みにくくなります。

   $ git log
   commit 71d9b3e (HEAD -> main)
   
       バターを追加
   
   commit a1c4f20
   
       店のメモを追加
   
   commit e5c0a62
   
       パンを追加
   
   commit 8b41d07
   
       卵を追加
   
   commit 3f2a9c1
   
       牛乳を追加

3. --oneline を付けると、1つのコミットが1行 になります。左が ID の先頭7桁、右がメッセージで、上ほど新しいコミットです。

   $ git log --oneline
   71d9b3e (HEAD -> main) バターを追加
   a1c4f20 店のメモを追加
   e5c0a62 パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

4. グラフにある「ジャムを追加」は出てきません。git log は、HEAD から親を辿れるコミットだけ を並べるからです。「ジャムを追加」は main の祖先ではありません。

5. -3 を付けると、新しい方から3つだけを出します。Claude Code がいちばんよく打つ git log がこの形です。

   $ git log --oneline -3
   71d9b3e (HEAD -> main) バターを追加
   a1c4f20 店のメモを追加
   e5c0a62 パンを追加

6. -1 なら最新の1つだけです。いま HEAD にあるのがどのコミットかを、1行で確かめられます。

   $ git log --oneline -1
   71d9b3e (HEAD -> main) バターを追加

7. -n 2 は -2 と同じ意味です。どちらの書き方も見かけます。

   $ git log --oneline -n 2
   71d9b3e (HEAD -> main) バターを追加
   a1c4f20 店のメモを追加

括弧の読み方と --all・ブランチ指定

1. 1行目の後ろに (HEAD -> main) と出ています。括弧の中は、そのコミットを指している付箋 の一覧です。

   $ git log --oneline
   71d9b3e (HEAD -> main) バターを追加
   a1c4f20 店のメモを追加
   e5c0a62 パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

2. HEAD -> main の矢印は「HEAD が main に乗っていて、main がこのコミットを指している」という意味です。グラフの札の並びと同じことを、文字で書いています。

   $ git log --oneline -1
   71d9b3e (HEAD -> main) バターを追加

3. 後ろにブランチ名を書くと、HEAD ではなく そのブランチから 親を辿ります。「ジャムを追加」が出て、「店のメモを追加」と「バターを追加」は出ません。括弧は (feature) だけで、HEAD の矢印はありません。

   $ git log --oneline feature
   d2b7f48 (feature) ジャムを追加
   e5c0a62 パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

4. --all は、すべてのブランチから辿れるコミット を並べます。グラフに見えているコミットが全部出ました。

   $ git log --oneline --all
   71d9b3e (HEAD -> main) バターを追加
   a1c4f20 店のメモを追加
   d2b7f48 (feature) ジャムを追加
   e5c0a62 パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

5. HEAD を feature に乗り換えてから、もう一度見てみます。

   $ git switch feature
   Switched to branch 'feature'

6. 括弧が変わりました。「ジャムを追加」は (HEAD -> feature)、「バターを追加」は (main) です。矢印が付いている方が、いま乗っているブランチ です。

   $ git log --oneline --all
   71d9b3e (main) バターを追加
   a1c4f20 店のメモを追加
   d2b7f48 (HEAD -> feature) ジャムを追加
   e5c0a62 パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

7. main に戻しておきます。git log も git switch も、コミットを1つも作らず、消しもしていません。

   $ git switch main
   Switched to branch 'main'

HEAD~1・HEAD~2・HEAD^ — 何個前の書き方

1. コミットは ID で指せますが、毎回7桁を書くのは面倒です。そこで「HEAD から何個前」という書き方があります。

   $ git log --oneline -3
   71d9b3e (HEAD -> main) バターを追加
   a1c4f20 店のメモを追加
   e5c0a62 パンを追加

2. HEAD~1 は HEAD の1つ前（親）です。「店のメモを追加」が出ました。

   $ git log --oneline -1 HEAD~1
   a1c4f20 店のメモを追加

3. HEAD~2 は2つ前、つまり親の親です。「パンを追加」です。

   $ git log --oneline -1 HEAD~2
   e5c0a62 パンを追加

4. HEAD^ は HEAD~1 と同じ意味です。~ の後ろの数字が「何個前」です。

   $ git log --oneline -1 HEAD^
   a1c4f20 店のメモを追加

5. HEAD の代わりにブランチ名にも付けられます。feature~1 は「パンを追加」で、main の2つ前と同じコミットです。ここが 2本のブランチの分かれ目 です。

   $ git log --oneline -1 feature~1
   e5c0a62 パンを追加

6. -1 を外すと、HEAD~2 から古い方へ全部を並べます。git log に書く rev は「どこから辿り始めるか」の指定です。

   $ git log --oneline HEAD~2
   e5c0a62 パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

git show と --stat・--name-only

1. git show は、1つのコミットの中身 を見るコマンドです。何も書かなければ HEAD のコミットを出します。見出しとメッセージの下に、親のコミットとの差分が続きます。

   $ git show
   commit 71d9b3e (HEAD -> main)
   
       バターを追加
   
   diff --git a/notes.txt b/notes.txt
   --- a/notes.txt
   +++ b/notes.txt
   +バターは冷蔵の棚
   diff --git a/todo.txt b/todo.txt
   --- a/todo.txt
   +++ b/todo.txt
   +バターを買う

2. + で始まる行が、このコミットで足された行です。「バターを追加」では todo.txt と notes.txt の2つのファイルに1行ずつ足しています。

3. --stat を付けると、差分の中身の代わりに ファイルごとの増減 だけが出ます。最後の行がその合計です。何ファイルを変えたコミットかが、すぐに分かります。

   $ git show --stat
   commit 71d9b3e (HEAD -> main)
   
       バターを追加
   
    notes.txt | 1 +
    todo.txt  | 1 +
    2 files changed, 2 insertions(+)

4. --name-only は、変わったファイルの名前だけを出します。

   $ git show --name-only
   commit 71d9b3e (HEAD -> main)
   
       バターを追加
   
   notes.txt
   todo.txt

5. 見たいコミットを後ろに書けます。「店のメモを追加」で変わったのは notes.txt だけです。

   $ git show --stat HEAD~1
   commit a1c4f20
   
       店のメモを追加
   
    notes.txt | 1 +
    1 file changed, 1 insertion(+)

6. ID でも指せます。「卵を追加」は、todo.txt に「卵を買う」を1行足したコミットでした。

   $ git show 8b41d07
   commit 8b41d07
   
       卵を追加
   
   diff --git a/todo.txt b/todo.txt
   --- a/todo.txt
   +++ b/todo.txt
   +卵を買う

git diff コミット — あるコミットと今の作業ツリー

1. 作業ツリーの todo.txt に「チーズを買う」を書き足して、まだコミットしていない状態です。

2. ステージに写します。作業ツリーとステージが同じ中身になりました。

   $ git add todo.txt

3. 何も出ません。何も付けない git diff は ステージと作業ツリー の差を見るので、add した後は空になります。

   $ git diff

4. HEAD を書くと、比べる相手が HEAD のコミット に変わります。add したかどうかに関係なく、コミット以降の変更がすべて出ます。

   $ git diff HEAD
   diff --git a/todo.txt b/todo.txt
   --- a/todo.txt
   +++ b/todo.txt
   +チーズを買う

5. HEAD~1 と今の作業ツリーを比べると、「バターを追加」で入れた2行とチーズの1行が、まとめて出ます。あるコミットから今までに何が変わったか を見る書き方です。

   $ git diff HEAD~1
   diff --git a/notes.txt b/notes.txt
   --- a/notes.txt
   +++ b/notes.txt
   +バターは冷蔵の棚
   diff --git a/todo.txt b/todo.txt
   --- a/todo.txt
   +++ b/todo.txt
   +バターを買う
   +チーズを買う

6. --stat は git diff にも付けられます。「パンを追加」の時点から、2つのファイルが変わっています。

   $ git diff --stat HEAD~2
    notes.txt | 2 ++
    todo.txt  | 2 ++
    2 files changed, 4 insertions(+)

Claude Code がコミットの前後に確かめていること

1. Claude Code がファイルを書き換えたあとの状態です。まず git status で、どのファイルが変わったかを見ます。

   $ git status
   On branch main
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   todo.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

2. 次に git diff --stat で、何ファイルを何行ずつ変えたか を確かめます。思っていないファイルまで変わっていないかを見る一手です。

   $ git diff --stat
    todo.txt | 1 +
    1 file changed, 1 insertion(+)

3. コミットに入れるファイルをステージに写します。

   $ git add todo.txt

4. --cached は HEAD とステージ の差です。これからコミットされる中身が、意図どおりかを最後に見ます。

   $ git diff --cached --stat
    todo.txt | 1 +
    1 file changed, 1 insertion(+)

5. コミットします。main が新しいコミットへ進みました。

   $ git commit -m "チーズを追加"
   [main 3387031] チーズを追加
    1 file changed, 1 insertion(+)

6. git log --oneline -3 で、直前のコミットが歴史の先頭に入ったか を確かめます。1行目に (HEAD -> main) と「チーズを追加」が並んでいれば成功です。

   $ git log --oneline -3
   3387031 (HEAD -> main) チーズを追加
   71d9b3e バターを追加
   a1c4f20 店のメモを追加

7. 最後に git show --stat で、そのコミットが 何ファイルを変えたか を見ます。todo.txt の1ファイルだけです。どれも見るだけのコマンドで、何も変えません。

   $ git show --stat
   commit 3387031 (HEAD -> main)
   
       チーズを追加
   
    todo.txt | 1 +
    1 file changed, 1 insertion(+)