分离 HEAD 状态处理

分离 HEAD（Detached HEAD）是 HEAD 指针直接指向提交而非分支名的状态。

什么是分离 HEAD

正常状态：

HEAD → main → commit C
HEAD 指向分支名，分支名指向提交

分离状态：

HEAD → commit C（直接指向提交）
HEAD 不指向任何分支名

进入分离 HEAD 的方式

检出特定提交

git checkout <commit-hash>
# You are in 'detached HEAD' state

# 示例
git checkout a1b2c3d

检出标签

git checkout <tag-name>
# 也进入分离 HEAD 状态

# 示例
git checkout v1.0.0

检出远程分支

git checkout origin/feature
# 直接检出远程分支引用

分离 HEAD 的提示

$ git checkout a1b2c3d
Note: switching to '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.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -c with the switch command. Example:

  git switch -c <new-branch-name>

Or undo this operation with:

  git switch <branch>

分离 HEAD 状态的工作

# 可以查看历史
git log

# 可以创建提交
git add .
git commit -m "修改"

# 提交不会被任何分支保存！

保存分离 HEAD 的修改

创建新分支

# 方法1：switch 创建分支
git switch -c new-branch

# 方法2：checkout 创建分支
git checkout -b new-branch

# 分支会保存所有提交

合入已有分支

# 记住提交哈希
git log --oneline

# 切回分支
git checkout main

# cherry-pick 提交
git cherry-pick <detached-commit>

丢弃分离 HEAD 的修改

# 直接切换回分支
git checkout main
git switch main

# 分离状态的修改会被丢弃
# 如果未创建分支保存

分离 HEAD 的用途

查看历史版本

# 检出历史版本查看
git checkout v1.0.0
# 查看、测试、分析
git checkout main  # 返回

运行历史版本测试

# 检出历史版本运行测试
git checkout a1b2c3d
npm run test

# 返回当前版本
git checkout main

基于 tag 创建分支

# 从 tag 创建维护分支
git checkout v1.0.0
git checkout -b maintain/v1.0

分离 HEAD 风险

风险：
- 在分离状态提交后切换分支
- 提交会"丢失"（实际可用 reflog 找回）

防范：
- 有意提交时立即创建分支
- 切换前确认是否要保存

找回分离 HEAD 的提交

# 分离状态的提交"丢失"了
git checkout main

# 用 reflog 找回
git reflog
# 找到分离状态的提交

# 创建分支保存
git checkout -b recovery <commit>

分离 HEAD 处理流程

进入分离 HEAD：
git checkout <commit/tag>

查看状态：
git status  # 显示 detached HEAD

如果需要修改：
→ 立即创建分支保存
git checkout -b <new-branch>

如果只是查看：
→ 直接切换回分支
git checkout main

分离 HEAD 时有意提交，必须创建分支保存。

要点总结

1. HEAD 直接指向提交而非分支名
2. checkout <commit/tag> 进入分离状态
3. 分离状态可提交但不会被分支保存
4. 有意修改时立即 checkout -b 创建分支
5. 丢失的提交可用 reflog 找回