这个问题确实挺头疼的——手动逐个fork子模块不仅效率低，还容易漏掉嵌套的子模块。我来分享两个实用的解决方案，分别对应批量fork和自动更新的需求：

1. 用GitHub官方CLI（gh）快速实现 #

这是最省心的方式，适合大多数场景：

• 先确保你已经安装了gh CLI，并且通过gh auth login完成登录，权限要包含仓库操作权限。
• 打开终端进入你的主仓库本地目录，运行下面的命令就能遍历所有层级的子模块并批量fork：

git submodule foreach --recursive '
  # 兼容HTTPS和SSH格式的仓库URL，提取owner/repo部分
  if [[ $url == git@github.com:* ]]; then
    repo_path=${url#git@github.com:}
  elif [[ $url == https://github.com/* ]]; then
    repo_path=${url#https://github.com/}
  fi
  repo_path=${repo_path%.git}
  echo "Forking $repo_path..."
  gh repo fork "$repo_path" --clone=false
'

• 小提示：--clone=false参数会跳过本地克隆，大幅加快fork速度；如果只想处理一级子模块，去掉--recursive即可。

2. 用GitHub API写自定义脚本（适合复杂场景） #

如果需要更灵活的控制（比如指定fork到组织、跳过已fork的仓库），可以用Python写个自定义脚本：

import os
import requests
from git import Repo  # 先安装依赖：pip install gitpython requests

# 替换成你的GitHub个人访问令牌（PAT），需要勾选repo权限
GITHUB_TOKEN = "your_personal_access_token_here"
HEADERS = {"Authorization": f"token {GITHUB_TOKEN}"}

def fork_repo(owner, repo_name):
    api_url = f"https://api.github.com/repos/{owner}/{repo_name}/forks"
    response = requests.post(api_url, headers=HEADERS)
    if response.status_code == 202:
        print(f"✅ Successfully forked {owner}/{repo_name}")
    elif response.status_code == 422:
        print(f"ℹ️ {owner}/{repo_name} is already forked, skipping")
    else:
        print(f"❌ Failed to fork {owner}/{repo_name}: {response.text}")

# 打开本地主仓库
main_repo = Repo(os.getcwd())

# 遍历所有子模块（包括嵌套子模块）
for submodule in main_repo.submodules:
    repo_url = submodule.url
    # 提取仓库的owner和名称
    if repo_url.startswith("git@github.com:"):
        repo_path = repo_url[15:-4] if repo_url.endswith(".git") else repo_url[15:]
    elif repo_url.startswith("https://github.com/"):
        repo_path = repo_url[19:-4] if repo_url.endswith(".git") else repo_url[19:]
    else:
        print(f"⚠️ Skipping non-GitHub submodule: {repo_url}")
        continue
    owner, repo_name = repo_path.split("/")
    fork_repo(owner, repo_name)

1. 上游子模块更新后，自动同步到你的fork并更新主仓库 #

用GitHub Actions实现全自动化，每天定时同步：
在主仓库根目录创建.github/workflows/update-submodules.yml文件：

name: Auto Update Submodules
on:
  schedule:
    - cron: "0 0 * * *"  # 每天凌晨运行一次，可自定义时间
  workflow_dispatch:  # 允许手动触发同步

jobs:
  sync-submodules:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout main repo
        uses: actions/checkout@v4
        with:
          submodules: recursive
          fetch-depth: 0
          token: ${{ secrets.PAT }}  # 在仓库Secrets中添加你的PAT

      - name: Configure Git
        run: |
          git config --global user.name "GitHub Actions Bot"
          git config --global user.email "actions-bot@github.com"

      - name: Sync submodules with upstream
        run: |
          git submodule foreach --recursive '
            # 添加上游仓库（如果尚未添加）
            if ! git remote | grep -q upstream; then
              git remote add upstream $url
            fi
            git fetch upstream
            # 合并上游最新代码（仅快进，避免冲突）
            git checkout main
            git merge upstream/main --ff-only
            # 推送到你的fork
            git push origin main
            cd ..
          '
          # 检查主仓库的子模块引用是否需要更新
          if git diff --name-only | grep -q ".gitmodules"; then
            git add .gitmodules */.gitmodules
            git commit -m "Auto update submodules to latest upstream versions"
            git push origin main
          else
            echo "No submodule updates needed"
          fi

• 注意：如果子模块合并时出现冲突，Workflow会失败，需要手动处理冲突后重新运行。

2. 你的子模块fork更新后，自动同步到主仓库 #

当你修改了自己的子模块fork并推送后，自动更新主仓库的子模块引用：
在子模块fork仓库创建.github/workflows/update-main-repo.yml：

name: Update Main Repo Submodule
on:
  push:
    branches: [ main ]  # 子模块的main分支有推送时触发

jobs:
  update-main:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout main repo
        uses: actions/checkout@v4
        with:
          repository: your-username/your-main-repo-name  # 替换成你的主仓库路径
          submodules: recursive
          token: ${{ secrets.PAT }}  # 添加有主仓库推送权限的PAT

      - name: Update submodule reference
        run: |
          cd path/to/your/submodule  # 替换成子模块在主仓库中的路径
          git pull origin main
          cd ../..
          git add path/to/your/submodule
          git commit -m "Update submodule [your-submodule-name] to latest version"
          git push origin main

总的来说，用gh CLI是批量fork子模块最快捷的方式，而GitHub Actions则是实现自动更新的最优方案——既不用手动操作，又能保证代码的及时性。

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