GitのDetached HEAD（分離HEAD）とは？発生原因と安全な復旧方法を解説

Gitを使っていると、突然「detached HEAD（分離されたHEAD）」という状態に遭遇することがあります。日常的にはあまり出会わない現象ですが、仕組みを理解しておけば慌てずに対処できます。この記事では、detached HEADの正体と、コミットを失わずに復旧する方法をわかりやすく解説します。

おさらい：Gitの基本構造

HEADを理解するために、まずGitの内部構造をおさらいしましょう。

1. 作業ディレクトリ（Working Directory）：ローカルの作業フォルダそのものです。git statusを実行すると、現在の作業ディレクトリの状態を確認できます。
2. HEAD：現在チェックアウトしているブランチの最新コミットへのポインタです。ブランチを切り替えると、HEADも新しいブランチの最新コミットへ移動します。
3. インデックス（Index）：ステージングエリアとも呼ばれます。git addでファイルを追加すると、コミット前にここに登録されます。

通常の状態（Attached HEAD）とは

HEADは「今いるブランチの最新コミット」を指し示しています。git statusを実行すれば On branch master のように現在のブランチ名が表示され、git logでは以下のようなコミット履歴を確認できます。

commit 38373004b8f651b58cea64cd629e1e2c18c164a0 (HEAD -> master, origin/master, origin/HEAD)
Author: Felipe <email>
Date:   Wed Sep 29 22:57:59 2020 -0500

たとえば git checkout development でdevelopmentブランチに切り替えると、HEADはdevelopmentブランチの最新コミットへ移動します。このように、通常の状態ではHEADは常に「今いるブランチの先端コミット」に追従して動きます。これが「アタッチされた（attached）HEAD」の状態です。

HEADがデタッチされるケース

HEADがデタッチする主なきっかけは次の3つです。

• git checkout --detach コマンドを明示的に実行する
• ブランチ名ではなくコミットハッシュを指定してチェックアウトする（例：git checkout 38373004b8f651b58cea64cd629e1e2c18c164a0）
• ブランチ名に ^0 を付けてチェックアウトする（例：git checkout master^0）

意図的にHEADをデタッチしたい場面はそれほど多くありません。実際に多いのは、「ブランチに切り替えようとしたつもりが、うっかりコミットハッシュを指定してしまった」というミスによるものです。

detached HEADになると、次のような警告メッセージが表示されます。

$ git checkout 38373004b8f651b58cea64cd629e1e2c18c164a0
Note: checking out '38373004b8f651b58cea64cd629e1e2c18c164a0'.

You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout.

この状態で変更を加えても、git statusの結果は次のように表示されます。

HEAD detached at ac63806
nothing to commit, working tree clean

つまり、時間の中で凍りついたような状態になり、どんな操作をしてもどこにも記録されません。なぜなら、HEADがどのブランチも指していないからです。

一方で、この性質を逆手にとり、リポジトリの過去の状態を壊す心配なく自由に調査・検証できると考える開発者もいます。実験的な変更を試すサンドボックスとして活用できるのです。

HEADを再アタッチする方法

まず覚えておきたい重要なポイントとして、detached HEADの状態になっても、既存のブランチには一切影響しません。その点は安心してください。

HEADを再アタッチする最も簡単な方法は、新しいブランチを作成することです。

git checkout -b <branch-name>

では、detached HEADになっていることに気づかずに変更を加えてしまった場合はどうすればよいのでしょうか。その場合は、一時的なブランチを作成し、それを目的のブランチにマージします。

git checkout -b temp-branch
git checkout master
git merge temp-branch

これで、一時ブランチ上の変更がmasterブランチに取り込まれ、せっかくのコミットが失われることはありません。

まとめ

今回は、Gitにおけるdetached HEADの仕組みと、その後の対処法について学びました。Git内部でのHEADの役割を理解しておくことで、detached HEADのような特殊な状況にも落ち着いて対応できるようになります。

万が一detached HEADの状態になっても焦る必要はありません。ただし、HEADがどのブランチにも紐づいていない間に行った変更やコミットは、どこにも反映されないという点は忘れないでください。新しいブランチの作成やマージを通じて、必ずHEADを再アタッチしましょう。