できない.dev

detached HEAD

別名: デタッチドヘッド / detached HEAD state / HEAD 分離

detached HEAD は、HEAD がブランチではなく特定のコミットを直接指している状態。
この状態でのコミットはどのブランチにも属さず、別のブランチへ移動すると参照されなくなり見失いやすい。

公開: 更新:

定義

detached HEAD は、HEAD がブランチではなく特定のコミットを直接指している状態である。
通常 HEAD はブランチ名を指し、そのブランチがコミットを指す。
この状態では間のブランチが無くなり、HEAD が直接コミットに貼り付く。
Git で過去のコミットを git checkout <sha> したときなどに起こる。

詳細

タグやリモート追跡ブランチ、特定コミットを checkout すると detached HEAD になる。
この状態でもコミットは作れるが、生成したコミットはどのブランチからも参照されない。
残したい場合は、git switch -c <新ブランチ>(または git checkout -b)でブランチを作ってから移動する。

よくある誤解

detached HEAD は「壊れた状態」ではない。
作業位置がブランチから外れているだけで、正常な Git の機能である。
ただしブランチを作らずに別の場所へ移動すると、そのコミットは迷子になり、git reflog を辿らないと見つけにくくなる。

関連

この状態から戻れないときの手順は、Git で detached HEAD 状態から戻れない にまとめてある。