浅初始化后如何让Git子模块追踪分支或转为非浅克隆

一、将所有子模块转为非浅克隆 #

无需重新克隆主仓库，可通过以下命令批量处理所有子模块（包括嵌套子模块），将浅克隆转为完整克隆：

git submodule foreach --recursive git fetch --unshallow

若你的Git版本不支持--unshallow参数，可改用设置足够大深度的方式强制拉取全部历史：

git submodule foreach --recursive git fetch --depth=1000000

执行后，所有子模块都会获取完整提交历史，后续分支操作将与普通克隆仓库一致。

二、让子模块追踪远程分支 #

1. 确认子模块的远程分支 #

进入目标子模块目录（比如cd content），执行以下命令查看远程分支列表：

git branch -r

你之前执行git checkout content报错，大概率是因为子模块的远程分支并非content，请以实际显示的分支名为准。

2. 单个子模块设置分支追踪 #

进入子模块目录后，按以下步骤操作：

• 切换到对应远程分支的本地分支（本地无分支则自动创建）：

git checkout main  # 替换为实际远程分支名

• 设置本地分支追踪远程分支：

git branch --set-upstream-to=origin/main main

3. 批量设置所有子模块分支追踪 #

若所有子模块需要追踪的远程分支名一致（比如都是main），可通过以下命令批量处理：

git submodule foreach 'git checkout main && git branch --set-upstream-to=origin/main main'

若子模块分支名不同，需逐个调整命令中的分支名称。

4. 持久化分支追踪配置（可选） #

若想让后续git submodule update --remote自动追踪分支，可修改主仓库的.gitmodules文件，在对应子模块的配置块中添加branch字段：

[submodule "content"]
    path = content
    url = https://github.com/xxx/xxx.git
    branch = main  # 替换为实际分支名

随后执行以下命令同步配置并更新子模块：

git submodule sync --recursive
git submodule update --recursive --remote

内容的提问来源于stack exchange，提问作者vishvAs vAsuki