【Git】detached HEAD状態から元の作業ブランチに戻す方法｜7シナリオ診断と救済・予防完全ガイド

$ git status
HEAD detached at a1b2c3d

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 switching back to a branch.

# 通常状態：HEAD はブランチを指す
cat .git/HEAD
# → ref: refs/heads/main

# detached 状態：HEAD はコミットSHAを直接指す
cat .git/HEAD
# → a1b2c3d4e5f6...

# 一発で判定
git symbolic-ref -q HEAD
# 通常: refs/heads/main
# detached: 何も表示されず終了コード1

# detached かどうか
git status
# "HEAD detached at XXX" が出れば detached

# HEADの生情報
git symbolic-ref -q HEAD
# 何も表示されなければ detached

# どこから来たか（直前のブランチ）
git reflog -10
# 出力例:
# a1b2c3d HEAD@{0}: checkout: moving from main to a1b2c3d
# e4f5g6a HEAD@{1}: commit: 前のcommit
# i7j8k9l HEAD@{2}: checkout: moving from feature to main

# detached中にコミットしているかチェック
git log --oneline HEAD ^$(git branch --format='%(refname:short)' | tr '\n' ' ')
# 出力があれば、どのブランチにも紐づかないコミット

# 直前のブランチに戻る（もっとも簡単）
git switch -
# または
git checkout -

# ブランチ名を指定して戻る
git switch main
git switch feature/login

# 戻った後の状態確認
git status
# → On branch main

# 現在位置（コミット積んだ先）を新ブランチとして固定
git switch -c rescue/my-work

# これでdetachedコミットはrescue/my-workブランチの履歴になった
git log --oneline -5

# 必要に応じてpushで保全
git push -u origin rescue/my-work

# その後、元のブランチへ安心して戻れる
git switch main

# 過去のHEAD履歴からSHAを探す
git reflog -20

# detached時のコミットSHAを特定したら
git switch -c rescue/lost-work <SHA>

# 直後なら簡単だが、reflog期限（90日）を超えると救済不可

# bisect 開始
git bisect start
git bisect bad HEAD
git bisect good v1.0.0
# → detachedで中間コミットにcheckoutされる

# 動作確認して good/bad を伝える
git bisect good
# または
git bisect bad

# bisect 終了して元ブランチに戻る
git bisect reset

# 指定コミットでworktreeを作る（detached）
git worktree add --detach ../review-pr a1b2c3d

# そのworktreeに移動
cd ../review-pr
git status
# HEAD detached at a1b2c3d

# そのまま参照用に使うならそれで良い
# 作業するならブランチを切る
git switch -c scratch/review

# submoduleを初期化すると各submoduleがdetachedになる
git submodule update --init --recursive

# submodule内に入って作業するなら
cd path/to/submodule
git switch main   # またはsubmoduleの開発ブランチに

# submoduleは各々独立したリポジトリ

# 過去コミットから作業するなら最初からブランチ化
git switch -c scratch/old-check a1b2c3d

# タグから始める場合も同じ
git switch -c hotfix/v1.2.1 v1.2.0

# リモート追跡ブランチから
git switch -c review/pr-42 origin/feature/pr-42

# 単に履歴を見るだけなら switch せずに show / log でOK
git show a1b2c3d
git log -p a1b2c3d
git log --graph --all --oneline

# 検証用scratch branchをSHAから切る
git config --global alias.scratch '!f() { git switch -c "scratch/$(date +%Y%m%d-%H%M)" "$1"; }; f'

# 使用例
git scratch a1b2c3d
# → scratch/20260101-1530 という使い捨てブランチを自動で作る

git checkout v1.2.0
# HEAD detached at v1.2.0

# 中身を見るだけで作業しないなら直接戻る
git switch -
# または
git switch main

# 現在位置確認
git log --oneline -5

# 救済ブランチを切って保全
git switch -c rescue/my-experiments

# pushで保全（お好みで）
git push -u origin rescue/my-experiments

# 必要なコミットをmainへ移す場合
git switch main
git cherry-pick <SHA>

git reflog --all -30
# 出力からdetached時のSHAを特定
# a1b2c3d HEAD@{3}: commit: 消したくないコミット

# SHAからブランチ化
git switch -c rescue/recovered a1b2c3d

# まず元のブランチに戻る
git bisect reset
# → bisect開始前のブランチに自動で戻る

# bisect情報を確認
git bisect log