GitLab仓库内GitHub第三方子模块无法拉取最新版本如何解决？

你遇到的报错核心是大部分GitHub新建公开仓库的默认主分支已从master改为main，Git子模块默认尝试追踪master分支，找不到对应分支就会抛出匹配失败、缺唯一修订版本的错误。另外git submodule update --init --recursive默认只会拉取父仓库中绑定的旧版本提交，不会主动拉取子模块远程的最新版本，所以执行后无变化。

第一步：确认子模块的实际远程主分支 #

• 先进入子模块的本地目录：

  cd 替换为你的子模块本地路径
  

• 查看所有远程分支确认主分支名称：

  git branch -a
  

  输出中remotes/origin/开头的分支里，带HEAD -> origin/xxx标注的就是实际默认主分支，通常为main或master。

第二步：选择对应更新方案 #

方案1：临时拉取子模块最新版本 #

直接在子模块目录拉取对应远程主分支的最新提交即可：

# 把main替换为你上一步查到的实际主分支名
git pull origin main

拉取完成后回到父仓库根目录，执行git add 子模块路径后提交，即可把父仓库绑定的子模块提交指针更新到最新版本。

方案2：永久配置子模块追踪分支，后续可直接批量更新 #

• 回到父仓库根目录，执行以下命令指定子模块的追踪分支（把对应占位符替换为你的实际信息）：

  git config -f .gitmodules submodule.你的子模块名称.branch 实际主分支名（如main）
  

• 后续需要更新所有子模块到最新版本时，直接执行以下命令即可，不会再报找不到分支的错误：

  git submodule update --remote --merge
  

如果子模块目录有未提交的本地修改，更新前请先备份或执行git stash暂存修改，避免拉取时产生冲突。

内容的提问来源于stack exchange，提问作者Friedrich -- Слава Україні