修复git submodule引起的detached head

最新推荐文章于 2026-06-05 16:09:48 发布

翻译最新推荐文章于 2026-06-05 16:09:48 发布 · 5.1k 阅读

标签

#git

收录于

HackTrick 同时被 2 个专栏收录

11 篇文章

订阅专栏

git

5 篇文章

订阅专栏

本文总结了在Git子模块中修复分离头状态的方法，包括重新建立子模块时使用-b参数追踪特定分支，以及使用一行命令递归修复所有子模块的分离头问题。

总结自：

Why is my GIT Submodule HEAD detached from master?
Git submodules best practices

上文记录了在子项目内修复detached head的方法，使用中发现是因为submodule使用不当引起的，当clone项目到其他位置时子项目内仍然是detached head。若对每个子项目都是用上文方法修复太过于麻烦，所以又查了两个修复方法，记录在此。

重新建立submodule，加入时使用-b参数，使得母项目追踪子项目的指定branch（否则默认不追踪）：

git submodule add -b <branch> <repository> [<submodule-path>]
git submodule update --remote

简单的一行命令递归修复所有子项目的detached head（其中默认都追踪子项目的master branch）：

git submodule foreach -q --recursive 'git checkout $(git config -f $toplevel/.gitmodules submodule.$name.branch || echo master)'

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

silent56_th

关注关注

0
点赞
踩
6

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

详解git submodule HEAD detached 的问题

10-14

主要介绍了详解git submodule HEAD detached 的问题，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

Git - submodule 小记

幻世

03-11

2180

一些对 submodule 疑惑的整理

参与评论您还未登录，请先登录后发表或查看评论

git submodule HEAD detached 的问题

YuZhuQue的博客

07-13

2860

在使用git submodule 的时候，常常会遇到执行完以下操作后发现子仓库的head 指针处于游离状态 git clone xxxxx.git git submodule update --init 然后切换到子仓库，查看当前分支的状态如下原因是之前同事在子仓库中修改并提交后，没有在父仓库中更新子仓库的最新提交记录正常情况下，修改子仓库的内容并在子仓库提交后会在父仓库执行 git diff会有如下输出解决git submodule head detached的方法：重新建

git submodule 使用

liubangbo的专栏

10-19

1992

文章转自：https://segmentfault.com/a/1190000020297996?utm_source=tag-newest 背景在做不同的项目，但是又都会使用到一些常用的方法组件代码块等等。作为一个追求优雅的开发人员，肯定不能接受一段代码到处复制粘贴的操作。而且一旦这段代码日后需要更新，到处粘贴的话就需要全局搜索然后含泪修改了。那么有没有一种办法，能够作为一些公共代码的“栖息地”，可以做到一处编写，到处使用呢？答案是有的，使用git内置功能submodule即可。什么是Su

git submodule update 游离分支临时分支问题记录解决办法

qq_38292379的博客

05-24

1687

git submodule update --init git pull origin master --recuresive-submodule 拉取子模块代码，子模块显示在临时分支上 $ git branch * (HEAD detached at da3251f) branch01 master 可以理解为submodule update拉取代码使用了checkout命令，而不关注具体是什么分支 git checkout xxx 因此在拉取子模块代码后，如果要进行开发，记得执行 $

git submodule

DongFuPanda的博客

05-14

456

最佳实践加入 submodule 建立 submodule 时使用 -b 参数，使得母项目追踪子项目的指定 branch（否则默认不追踪） git submodule add -b <branch> <repository> [<submodule-path>] git submodule update --remote 修复所有子项目的 detached head 如果没有加入 submodule 时没有加上 -b 参数，采用如下方式修复。这里跟踪的是 master

git 操作

l00102795的博客

04-21

258

git config --global pull.rebase true

Git Submodule踩坑实录：从‘空文件夹’到递归克隆失败的完整解决方案

最新发布

weixin_30421809的博客

06-05

437

本文深入剖析Git Submodule使用中的常见问题，包括空文件夹、递归克隆失败、版本错乱等，提供从原理到实战的完整解决方案。特别针对子模块管理中的权限问题、巨型仓库优化和团队协作规范给出专业建议，帮助开发者高效管理复杂项目依赖。

Git Submodule 使用简介

allanGold

11-01

937

D瓜哥从去年开始，将所有的笔记都整合到了自建的 Wiki 中。整理分析，确实方便很多。最近有两个部分，比较独立，自成系统。其中，有一个模块还考虑和其他小伙伴合作来搞。所以，就将这两部分抽取出来，独立成单独的项目来维护。但是，为方便查看和随时随地同步更新，正好可以使用 Git Submodule 特性。另外，还有一种场景：开发的项目使用了第三方或者公司的基础库，使用同一个版本库肯定不

git提醒---HEAD detached

Andy的博客

12-09

1455

git提醒---HEAD detached detached HEAD：表示HEAD指针已经是游离状态，没有指向Master分支，或者本地的任何一个具体分支，而是指向了一个commit_id。

git问题记录--如何从从detached HEAD状态解救出来

积硅步

03-21

8868

今天使用git的时候在终端发现这样一条信息 HEAD detached at head 分析心里一惊,艾玛这是什么状态? 其实我们知道,git checkout本质上是修改HEAD里面的内容来让它指向不同分支的,而HEAD文件指向的分支就是我们当前的分支,但是有时候HEAD不会指向任何分支,严谨的说是HEAD指向了一个没有分支名字的修订版本,此时恭喜你,已经处于游离状态了(detache

git--“HEAD detached from”的解决方法

IT利刃出鞘的博客

09-01

4092

本文介绍git的一个报错的解决方法。报错信息为：“HEAD detached from”

【Git】HEAD detached from xxx 问题及解决方案

destiny_balabala的博客

10-29

1937

简单来说，就是现在所在的commit不处于任何分支。比如下图：除了第一个commit和最后一个commit之外，其他的commit都不处于任何分支。但是我checkout的commit明明是最新的commit，不是在main分支上吗？为什么还是会报错呢？这里给出chatgpt的回答：就是说，切到任何一个commit，都会处于detatched HEAD状态。要想回到最新的分支上，得checkout到分支名，而不是commit哈希值。

TortoiseGit对submodule进行commit、push的问题：Current HEAD Detached

玄冬Wong

05-04

3006

如果提交submodule的时候提示这个信息：Current HEAD Detached，说明submodule已经和远程仓库脱离开了，如果你submodule中有未提交的改动，一定要手动备份下。然后在submodule所在的目录下，右键-》TortoiseGit-》switch/checkout-》Branch选择：Master，然后点击确定，然后再在当前submodule下进...

Git子模块管理中的常见陷阱与解决方案

MenzilBiz的博客

04-04

1006

Git子模块是一个独立的Git仓库，被嵌套在主Git仓库中。它允许你在项目中引用其他仓库的特定版本，同时保持两个项目的独立性。需要包含第三方库但希望保持其独立更新能力项目组件需要独立开发和版本控制多个项目共享公共组件文件：存储子模块的配置信息Git索引：记录子模块当前指向的具体提交Git子模块是一个强大的工具，但也需要谨慎使用。理解其工作原理和潜在问题，可以帮助你避免常见的陷阱，更高效地管理项目依赖。

git 的 Detached HEAD

bigcarp的专栏

02-27

972

在 Git 版本管理中，是指你当前的工作状态不再指向任何分支，而是指向一个特定的提交（commit）。通常情况下，HEAD是指向你当前工作分支的指针，例如main或。当你切换到一个特定的提交或标签（而不是分支）时，HEAD会指向该提交，而不再是分支的最新提交。这种状态下，Git 会显示类似于的提示，表示你当前处于一个“分离头指针”（detached HEAD）状态。在这种状态下做的修改和提交不会直接影响任何分支，它们仅会存在于你当前的提交历史中，直到你明确地切换到一个分支。

git submodule使用方法

蚂蚁搬家

03-17

6227

1. submodule简介 submodule是一种git特性，用以将一部分公共代码从主项目中抽离出来成为一个独立的git工程，并以submodule的形式被主项目使用，submodule和主项目（或者叫主模块）充分解耦，这样做的好处是作为submodule的公共代码可以被多个主项目工程使用，减少了开发量和版本控制负担。同时，submodule作为独立的git工程，也使得权限管理、版本迭代更加灵...

Git出现游离分支(HEAD detached from XXXX解决方法) 提交代码报错:error: src refspec dev does not match any

weixin_40151813的博客

07-27

1188

今天在提交代码时git push xxx xxx 之后出现如下错误，记录一下 git push origin dev error: src refspec dev does not match any 于是查看当前分支如下：可以看到当前在HEAD detached from origin/dev分支下，此为游离分支，是匿名的解决方法： 1.查看在游离状态下提交的最新commit号：执行git reflog命令或者执行git branch -v命令，两者其一即可 git reflog git branc

Git HEAD detached from XXX (git HEAD 游离) 解决办法