Git子模块能否自动跟踪分支最新提交？求可行实现方案

问题核心 #

希望避免子模块仓库有新提交时，每次手动执行git submodule update --remote，但现有配置后主仓库仍无法自动同步子模块的最新提交。

针对你的疑问的解答 #

1. 子模块的设计本质 #

是的，Git子模块本质上就是固定指向特定提交哈希，这是其核心设计理念——保证主仓库的构建一致性：无论何时克隆主仓库，子模块都会被拉取到对应提交，避免因子模块突发更新导致主仓库构建失败或行为异常。所谓的“跟踪分支”只是简化更新操作的辅助配置，并非让子模块自动实时同步远程分支的变更。

2. 自动更新的可行方案 #

Git原生不支持子模块完全自动同步，但可以通过以下工作流或工具实现半自动化/自动化更新：

方案一：Git钩子自动触发更新

在主仓库的.git/hooks目录下创建post-merge或post-checkout钩子脚本，当主仓库拉取新代码或切换分支后，自动执行子模块更新：

#!/bin/sh
# .git/hooks/post-merge
git submodule update --remote --merge

给脚本添加执行权限：

chmod +x .git/hooks/post-merge

注意：钩子脚本默认不会被Git跟踪，若要团队共享，可将脚本存放在仓库目录中，再配置Git使用该目录下的钩子：

git config core.hooksPath .githooks

之后将.githooks目录提交到仓库即可。

方案二：CI/CD流水线自动更新提交

如果子模块更新频繁，可借助CI/CD工具（如GitHub Actions、GitLab CI）定时触发，或在子模块有新提交时自动更新主仓库的子模块引用并提交：
示例GitHub Actions配置（.github/workflows/submodule-update.yml）：

name: Update Submodule
on:
  schedule:
    - cron: '0 */6 * * *' # 每6小时执行一次
  repository_dispatch:
    types: [submodule_updated] # 子模块仓库触发事件时执行

jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: true
          token: ${{ secrets.PAT }} # 需要有主仓库提交权限的PAT
      - name: Update submodule
        run: |
          git submodule update --remote --merge
      - name: Commit and push changes
        run: |
          git config --global user.name "GitHub Actions"
          git config --global user.email "actions@github.com"
          git add .
          git commit -m "Auto-update submodule to latest develop" || echo "No changes to commit"
          git push

方案三：改用Git子树替代子模块

如果你的场景更倾向于自动同步而非严格版本锁定，Git子树是更合适的选择：

• 将子模块仓库作为主仓库的一个子目录，直接合并其分支内容，无需单独的子模块配置
• 同步子模块最新代码只需执行：

git subtree pull --prefix=path/to/submodule origin develop --squash

• 推送主仓库对子目录的修改到子模块仓库：

git subtree push --prefix=path/to/submodule origin develop

补充说明 #

你之前配置的git submodule set-branch只是告诉Git：当执行git submodule update --remote时，默认拉取哪个分支的最新提交，而非自动同步。若想简化手动操作，可将该命令配置为别名：

git config --global alias.subup 'submodule update --remote --merge'

之后只需执行git subup即可完成子模块更新。

内容的提问来源于stack exchange，提问作者Anton Grant