ブランチと HEAD — 付箋が2段で指している

ブランチは付箋 — git branch で作る・見る

1. コミットが3つ並んでいます。黒い札の main が ブランチ、ピンクの札が HEAD です。どちらも、何かを指している 付箋 です。

2. git branch だけを打つと、ブランチの一覧が出ます。* が付いているのが、HEAD が乗っているブランチです。

   $ git branch
   * main

3. --show-current は、今乗っているブランチの名前だけを1行で出します。Claude Code は作業を始める前に、これでどのブランチにいるかを確かめます。

   $ git branch --show-current
   main

4. 後ろに名前を書くと、今いるコミットに付箋を1枚貼る だけです。ファイルは1つもコピーされず、作業ツリーも変わりません。

   $ git branch feature

5. 一覧に feature が増えました。ただし * は main に付いたままです。git branch 名前 は付箋を作るだけで、乗り換えはしません。

   $ git branch
     feature
   * main

6. (HEAD -> main, feature) は「このコミットに main と feature の2枚が貼ってあり、HEAD は main に乗っている」と読みます。同じコミットに、付箋は何枚でも貼れます。

   $ git log --oneline -1
   e5c0a62 (HEAD -> main, feature) パンを追加

7. 名前の後ろにコミット ID を書けば、過去のコミットにも付箋を貼れます。

   $ git branch old 8b41d07

8. --all を付けると、すべての付箋から辿れるコミットが出ます。付箋が3枚に増えても、コミットは3つのままです。

   $ git log --oneline --all
   e5c0a62 (HEAD -> main, feature) パンを追加
   8b41d07 (old) 卵を追加
   3f2a9c1 牛乳を追加

9. -a は、GitHub 側のブランチの写しも一緒に並べるオプションです。このリポジトリはまだ GitHub とつないでいないので、手元の一覧と同じです。

   $ git branch -a
     feature
   * main
     old

コミットで進むのは、HEAD が乗っているブランチだけ

1. main と feature が同じコミットに貼ってあります。git status の1行目 On branch main は「HEAD は main に乗っている」という意味です。

   $ git status
   On branch main
   nothing to commit, working tree clean

2. ファイルに1行足して、コミットしてみます。

   $ echo "バターを買う" >> todo.txt

3. 新しいコミットができ、HEAD が乗っている main だけ がそこへ進みました。feature は元のコミットに残っています。

   $ git commit -am "バターを追加"
   [main fbb4973] バターを追加
    1 file changed, 1 insertion(+)

4. HEAD は main を指したままなので、main に連れられて一緒に進みました。これが HEAD → ブランチ → コミット の2段で指す仕組みです。

   $ git log --oneline --all
   fbb4973 (HEAD -> main) バターを追加
   e5c0a62 (feature) パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

5. 今度は feature に乗り換えます。HEAD の付箋が feature に貼り替わり、作業ツリーは「パンを追加」の中身に戻ります。乗り換えの詳しい動きは、1-4の回で扱います。

   $ git switch feature
   Switched to branch 'feature'

6. 今乗っているのは feature です。

   $ git branch --show-current
   feature

7. ここでも1行足してコミットします。

   $ echo "ジャムを買う" >> todo.txt

8. 今度は feature だけが進み、main は動きません。2枚の付箋が別々のコミットを指し、歴史が二股に分かれ ました。

   $ git commit -am "ジャムを追加"
   [feature bee85e4] ジャムを追加
    1 file changed, 1 insertion(+)

9. どちらのコミットも消えていません。付箋が2枚あるので、両方の先端から歴史を辿れます。

   $ git log --oneline --all
   bee85e4 (HEAD -> feature) ジャムを追加
   fbb4973 (main) バターを追加
   e5c0a62 パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

git switch -c — ブランチを作って乗る

1. git branch idea で付箋を作ります。

   $ git branch idea

2. 乗っているのは main のままです。このままコミットすると、進むのは main です。

   $ git branch --show-current
   main

3. git switch -c 名前 は、付箋を作って、そのまま乗り換える コマンドです。HEAD の札が memo に移りました。

   $ git switch -c memo
   Switched to a new branch 'memo'

4. * が memo に付いています。3枚の付箋は、まだ同じコミットに貼ってあります。

   $ git branch
     idea
     main
   * memo

5. 新しいファイル notes.txt を作って、コミットします。

   $ echo "牛乳は低脂肪" > notes.txt

6. ステージに写しました。

   $ git add notes.txt

7. 進んだのは HEAD が乗っている memo だけです。main と idea は元のコミットに残っています。

   $ git commit -m "メモを追加"
   [memo ad1a0b0] メモを追加
    1 file changed, 1 insertion(+)
    create mode 100644 notes.txt

8. 作業用のブランチを switch -c で作ってからコミットすれば、main を動かさずに作業を積めます。

   $ git log --oneline --all
   ad1a0b0 (HEAD -> memo) メモを追加
   e5c0a62 (main, idea) パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

git branch -d — 付箋を剥がす

1. egg の付箋は「卵を追加」に貼ってあります。このコミットは main の歴史の途中にあるので、main からも辿れます。

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

2. git branch -d 名前 で付箋を剥がします。(was 8b41d07) は、剥がす前に貼ってあったコミットです。

   $ git branch -d egg
   Deleted branch egg (was 8b41d07).

3. 剥がしたのは付箋だけで、コミットは4つとも残っています。「卵を追加」は main から辿れるので、何も失っていません。

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

4. 今乗っているブランチは剥がせません。used by worktree は「この作業フォルダで使っている」という意味です。剥がすと、HEAD の行き先が無くなってしまうからです。

   $ git branch -d main
   error: cannot delete branch 'main' used by worktree at '/Users/you/memo-app'

-d が断るとき、-D で剥がすと

1. 試し用のブランチ try を作って乗ります。

   $ git switch -c try
   Switched to a new branch 'try'

2. 1行足して、try の上でコミットします。

   $ echo "試しに書く" >> todo.txt

3. try だけが1つ先へ進みました。「試し」のコミットは、今のところ try の付箋からしか辿れません。

   $ git commit -am "試し"
   [try 5f877b0] 試し
    1 file changed, 1 insertion(+)

4. main に戻ります。

   $ git switch main
   Switched to branch 'main'

5. -d は断りました。not fully merged は「このブランチには、今いる main の歴史に入っていないコミットがある」という意味です。剥がすとそのコミットを見失うので、-d は止まります。

   $ git branch -d try
   error: the branch 'try' is not fully merged
   hint: If you are sure you want to delete it, run 'git branch -D try'

6. -D（大文字）は、確認せずに剥がします。グラフで薄くなったのが、どの付箋からも辿れなくなった 「試し」のコミットです。

   $ git branch -D try
   Deleted branch try (was 5f877b0).

7. --all を付けても「試し」は出てきません。コミット自体はまだ残っていますが、ブランチから辿る方法ではもう見つかりません。

   $ git log --oneline --all
   e5c0a62 (HEAD -> main) パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

8. HEAD が過去にいた場所の記録（reflog）には、まだ「試し」が残っています。一定期間はここから取り戻せます。取り戻し方は3-4の回で扱います。

   $ git reflog -3
   e5c0a62 (HEAD -> main) HEAD@{0}: checkout: moving from try to main
   5f877b0 HEAD@{1}: commit: 試し
   e5c0a62 HEAD@{2}: checkout: moving from main to try