如果您试图通过重新签出文件而撤消所做的更改，并且语法不完全正确，则很容易发生这种情况。

你可以看看git日志的输出——你可以把上次成功提交后的日志尾部粘贴到这里，我们都可以看到你做了什么。或者你可以粘贴它，然后在freenode IRC上的#git中询问。

任何不是分支名称的提交签出都会得到一个分离的HEAD。SHA1表示树枝的顶端，仍然给出一个分离的HEAD。只有签出本地分支名称才能避免这种模式。

参见使用分离的HEAD进行承诺

当分离HEAD时，除了没有更新命名分支外，提交工作正常。(您可以将其视为一个匿名分支。)

例如，如果您签出一个“远程分支”而没有首先跟踪它，您可能会得到一个分离的HEAD。

见git:开关分支没有分离头

意思是:git签出origin/main(或者以前的origin/master)会导致:

Note: switching to 'origin/main'.

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 -

Turn off this advice by setting config variable advice.detachedHead to false

HEAD is now at a1b2c3d My commit message

这就是为什么你不应该再使用git checkout，而应该使用新的git switch命令。

使用git switch，同样尝试“签出”(切换到)远程分支将立即失败:

git switch origin/main
fatal: a branch is expected, got remote branch 'origin/main'

添加更多git开关:

使用Git 2.23(2019年8月)，你不必再使用令人困惑的Git checkout命令了。

git switch也可以签出一个分支，并获得一个分离的HEAD，除了:

它有一个显式的—detach选项

在不创建新分支的情况下提交HEAD~3进行临时检查或实验: git开关——分离HEAD~3 HEAD现在在9fc9555312合并分支cc/shared-index-permbits

它不能错误地分离远程跟踪分支

See:

C:\Users\vonc\arepo>git checkout origin/master
Note: switching to 'origin/master'.

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.

Vs.使用新的git switch命令:

C:\Users\vonc\arepo>git switch origin/master
fatal: a branch is expected, got remote branch 'origin/master'

如果你想创建一个新的本地分支来跟踪一个远程分支:

git switch <branch> 

如果没有找到<分支>，但是在恰好一个远程(称其为<远程>)中存在一个具有匹配名称的跟踪分支，则将其等效于 Git开关-c <分支>——track <远程>/<分支>

别再犯错了! 没有更多不想要的分离头!

如果你使用git switch <tag>而不是git switch——detach <tag>， git 2.36会帮助你记住缺失的——detach选项。

如果您试图通过重新签出文件而撤消所做的更改，并且语法不完全正确，则很容易发生这种情况。

你可以看看git日志的输出——你可以把上次成功提交后的日志尾部粘贴到这里，我们都可以看到你做了什么。或者你可以粘贴它，然后在freenode IRC上的#git中询问。

分离的头

HEAD是一个指向当前签出分支或提交的指针，它回答了一个问题:我现在在存储库的哪个位置?HEAD可以处于附加(默认)或分离两种状态之一，这取决于您是否签出了本地分支。

我的头是怎么脱落的?

操作比让HEAD处于分离状态

最终进入分离的HEAD状态可能是由于各种原因造成的，以下是5种常见的情况(也许你做过以下任何一种):

使用哈希表签出一个特定的提交。 $ git checkout 14ko3 显式地签出一个远程分支，即。 $ git checkout origin/master 使用分离标志切换到一个分支(Git 2.23)，即 $ git主开关——分离 签出一个标签，即 $ git checkout v1.0.1 执行一个交互式的重基(或者包含冲突变更的常规重基)，例如: $ git rebase master特性-1 -交互式

在分离状态下，可以在不影响任何现有分支的情况下进行实验更改。请参见下面的信息图，说明在附加状态和分离状态下提交的区别。

一个常见的误解是，消息You are in 'detached HEAD' state是错误的语气，而实际上它只是描述HEAD是如何引用当前快照的。

从分离到依附的状态

要从分离状态切换到附加状态，您可以从所在的位置创建一个新分支，或者切换回现有的分支。

注意:如果你切换到另一个现有的分支，在分离状态下创建的任何提交最终(垃圾收集后)都会被丢弃，而不是首先在一个新的分支中持久化你的更改。

来源:以上节选自这篇关于主题的完整文章:Git中的HEAD是什么?

如果您有一个与分支同名的标记，就会发生这种情况。

例如:如果“release/0.1”是标签名，那么

git checkout release/0.1

在“release/0.1”处产生分离的HEAD。如果您期望release/0.1是一个分支名称，那么您会感到困惑。

对于其他人可能正在寻找一种获得分支名称的方法，但却得到了HEAD，这是我想出的:

const { execSync } = require('child_process');

const getBranchName = () => {
  let branch = execSync('git rev-parse --abbrev-ref HEAD').toString().trim();
  if (branch === 'HEAD') branch = execSync(`git branch -a --contains HEAD | sed -n 2p | awk '{ printf $1 }'`).toString().trim();
  return branch;
}