如何实现Gitea仓库拉取时自动更新子模块至main分支最新版本？

先修正子模块基础配置 #

首先确保主仓库的.gitmodules文件里指定子模块跟踪main分支，这样Git才知道要拉取哪个分支的最新代码：

[submodule "your-submodule-name"]
    path = path/to/submodule
    url = https://your-gitea-url/your/shared-submodule.git
    branch = main

方案1：自定义Git别名（控制台/VS终端通用） #

git pull --recurse-submodules只会拉取主仓库记录的子模块commit，不会主动更新子模块的远程分支。我们可以创建一个复合命令别名，一键完成主仓库拉取+子模块更新：

# 全局配置（所有仓库可用）
git config --global alias.pull-all '!git pull && git submodule update --remote --merge'

之后不管是在控制台还是Visual Studio的内置终端，执行git pull-all即可：

• 先拉取主仓库最新代码
• 自动将所有子模块更新至main分支的远程最新版本（--merge会合并到本地子模块分支，避免游离HEAD状态）

方案2：Git钩子自动触发（无需手动输入命令） #

利用post-checkout和post-merge钩子覆盖拉取场景：

1. 在主仓库的.git/hooks目录下创建post-checkout脚本（无后缀）：

#!/bin/sh
# 无论是否切换分支，都更新子模块至main最新
git submodule update --remote --merge

2. 再创建post-merge脚本，内容同上：

#!/bin/sh
git submodule update --remote --merge

3. 给脚本添加执行权限：

chmod +x .git/hooks/post-checkout .git/hooks/post-merge

这样执行git pull时，只要触发了分支切换或合并操作（包括主仓库无变更但子模块有更新的场景），都会自动更新子模块。

方案3：Visual Studio集成设置 #

• 方法1：使用自定义别名
  打开VS的「团队资源管理器」→「设置」→「Git全局设置」→「配置编辑器」，添加别名pull-all，值为!git pull && git submodule update --remote --merge。之后在VS的「Git」菜单→「命令行」中执行git pull-all即可。
• 方法2：配置自动更新子模块
  打开VS的「工具」→「选项」→「源代码管理」→「Git全局设置」，找到「子模块更新策略」设置为「拉取时更新子模块」，同时执行以下命令让子模块默认合并远程最新：

  git config --global submodule.<your-submodule-name>.update merge
  

注意事项 #

• 确保子模块本地处于main分支，避免游离HEAD：进入子模块目录执行git checkout main
• 若多个主仓库共用该子模块，每个仓库都需配置.gitmodules的branch字段，或通过全局配置统一管理

内容的提问来源于stack exchange，提问作者Liam Lange