Git处于Detached HEAD状态无法提交，执行git checkout main报错求助

1. 确认当前目录是否为Git仓库工作树 #

执行命令查看Git仓库的根目录路径：

git rev-parse --show-toplevel

• 若输出有效路径，切换到该目录：cd <输出的路径>
• 若命令报错，说明当前不在Git仓库内或仓库已损坏，需先定位到正确的仓库目录。

2. 保存Detached HEAD状态下的修改 #

Detached HEAD状态无法直接提交到现有分支，需通过临时分支留存修改：

1. 暂存已修改的文件：

git add .

（仅需保存特定文件时，替换.为具体文件名）
2. 创建并切换到临时分支：

git checkout -b temp-save-branch

3. 提交修改：

git commit -m "保存Detached HEAD状态下的代码修改"

3. 切换回main分支并处理异常 #

在仓库根目录执行切换命令：

git checkout main

若仍报错，排查以下情况：

• 执行git status查看仓库状态，获取异常提示
• 检查.git目录是否完整，若该目录损坏，需从备份恢复（无备份时此操作可能丢失历史，谨慎执行）
• 执行git config --get core.bare，若输出true说明是裸仓库（无工作树），需转换为非裸仓库：

git config core.bare false
git reset --hard HEAD

（注意：reset --hard会覆盖当前工作树文件，需确保已提前保存修改）

内容的提问来源于stack exchange，提问作者Matt Cole