将已存在的git仓库移动到新建的父仓库下

October 9, 2026 · 9 min read

Happlay71

一个渴望成为技术大佬的小白

还原当时情景🔄️

为了方便，库的名称就用仓库1，仓库2...命名了

我当时具有两个本地仓库仓库1，仓库2，并且都已经连接到了远程仓库。

由于在与 AI 讨论下一步开发规划的时候，我引用的是我两个仓库的父文件夹，所以 AI 提供的下一步规划中包含了我父文件夹的 README.md 等的内容。

由于本人具有一点点强迫症😶‍🌫️以及有亿点懒，综合考虑之下，AI 说什么就是什么吧，因此我就考虑该如何不重复提交很多代码的情况下创建一个父仓库

如果是直接创建一个父仓库并连接远程的话那就简单多了，但是我之前单独创建的那两个仓库有什么意义呢？

AI 娘神力

OK，遇事不决，AI 神力。我直接把疑问甩给了 AI，不得不说，确实好使，还有多种方案。这里我就直接仍方案对比了昂，毕竟每个方案的字数也不少（ AI 可是不会省 TOKEN 的😶）

方案	保持独立	保留历史	克隆难度	适合场景
A. Submodule	✅	✅	⭐⭐	团队各自维护
B. Subtree	❌	✅	⭐	一个仓库管理所有
C. 直接复制	❌	❌	⭐	历史不重要

然后鉴于我既要有要的想法，那当然是选择 A 方案喽

解决方案

现在的场景有个关键点：仓库1 和仓库2 已经是完整的 git 仓库了，直接把它们作为 submodule 加进来，需要先把它们"挪出去"再添加

创建父仓库

登录你自己的 github ，然后创建一个父仓库，注意，不要勾选 "Add a README file" 和 ".gitignore"（保持空仓库） ，然后记住你的这个远程仓库的地址

https://github.com/你的用户名/父仓库.git

本地操作流程

进入父目录，初始化 git git init
将两个子仓库移动出去，因为 git submodule add 要求目标目录不存在或为空，最后父目录为空即可
添加两个子仓库为 submodule

用远程仓库的 URL（不是本地路径），这样别人克隆时才能拉到代码
```
git submodule add https://github.com/你的用户名/仓库1.git 仓库1
git submodule add https://github.com/你的用户名/仓库2.git 仓库2
```
执行后：
- 会从远程仓库拉取代码到本地对应目录
- 生成 .gitmodules 文件（记录两个子模块的 URL）
- 生成 .git/modules/ 目录（存 submodule 的元数据）

提交父仓库

git add .
git commit -m "初始化：引入前端和后端两个 submodule"

关联父仓库的远程地址并推送

git remote add origin https://github.com/你的用户名/父仓库.git
git branch -M main
git push -u origin main

最终结构

父仓库/                          ← 父仓库
├── .git/
├── .gitmodules                 ← 记录两个 submodule 的 URL
├── .git/modules/               ← submodule 的元数据
├── 仓库1/              ← 指向 仓库1 仓库的某个 commit
│   └── .git                    ← 这是个文件，不是目录，内容指向 .git/modules
└── 仓库2/             ← 指向 仓库2 仓库的某个 commit
    └── .git

OK，到这里我们的目的就算达到了，拥有了一个引用连接到两个子仓库的父仓库，非常完美............吗？

其实不然，目前只是可以引用了，但是子仓库要是更新呢？询问 AI 娘之后的结果是，如果子仓库更新，需要手动去更新父仓库才可以。🤡🤡

何意味？合着我给自己加了个麻烦？不可能，绝对不可能[无图，先欠着🌐]

父仓库代码自动提交

父仓库配置接收通知的 Actions

在本地父仓库的根目录下创建 .github/workflows/update-submodule.yml 文件

name: Update Submodule Reference

on:
# 接收来自子仓库的通知
repository_dispatch:
   types: [frontend-updated, backend-updated]
# 也支持手动触发
workflow_dispatch:

jobs:
update-submodule:
   runs-on: ubuntu-latest
   steps:
      - name: Checkout parent repo
      uses: actions/checkout@v4
      with:
         token: ${{ secrets.PARENT_REPO_TOKEN }}
         submodules: recursive
         fetch-depth: 0

      - name: Update submodules to latest
      run: |
         git submodule update --remote --merge

      - name: Commit and push if changed
      run: |
         git config user.name "github-actions[bot]"
         git config user.email "github-actions[bot]@users.noreply.github.com"
         git add .
         if git diff --staged --quiet; then
            echo "No changes to commit"
         else
            git commit -m "chore: 自动更新子模块引用"
            git push
         fi

repository_dispatch：监听子仓库发来的自定义事件
submodules: recursive：checkout 时拉取所有子模块
git submodule update --remote --merge：把子模块更新到最新 commit
用 secrets.PARENT_REPO_TOKEN：因为要 push 回父仓库，需要 Personal Access Token（PAT），而不是默认的 GITHUB_TOKEN（默认 token 无法触发下游 workflow）

生成 Personal Access Token（PAT）
- 登录 GitHub → 右上角头像 → Settings
- 左侧底部 → Developer settings
- Personal access tokens → Generate new token （class）
- 勾选权限：
  - ✅ repo（完整仓库权限）
  - ✅ workflow（如果需要触发其他 workflow）
  有效期我选的是永久，省的再续时间了，毕竟是我个人用，没必要搞得太复杂
- 生成后立刻复制（只显示一次）
- 回到父仓库 QLink → Settings → Secrets and variables → Actions
- 新建 Secret：名字 PARENT_REPO_TOKEN，值粘贴刚才的 token （这里选地下那个 Repository secrets 去创建新的 Secret）

子仓库配置触发通知的 Actions

以仓库1为例，同样在根目录下创建 .github/workflows/update-submodule.yml 文件

name: Notify Parent Repo

on:
push:
   branches:
      - main    # 改成你子仓库的默认分支（master 或 main）

jobs:
notify:
   runs-on: ubuntu-latest
   steps:
      - name: Trigger parent repo update
      uses: peter-evans/repository-dispatch@v3
      with:
         token: ${{ secrets.PARENT_REPO_TOKEN }}
         repository: 用户名/父仓库名
         event-type: frontend-updated

仓库二只需替换 event-type 为父仓库 yaml 文件中 repository_dispatch 里对应的名字即可

给子仓库也配置 Token

以仓库1为例

进入 qlink-frontend 仓库 → Settings → Secrets and variables → Actions → New repository secret：
- Name: PARENT_REPO_TOKEN
- Value: 粘贴刚才生成的那个 PAT

以上的部分内容为我直接CV AI 的结果，因为我懒，不要喷写的像 AI🫡，因为它就是 AI 写的😋

OK了，老铁们。本篇文章应该就到此为止了，毕竟我滴任务完成啦💥。其实后面还可以搞搞脚本的优化，像是父仓库能显示具体的子仓库提交了什么代码？如果自动化流程错误的话邮件通知？

如果大家有更好的想法欢迎联系我，我会找机会去实践的，祝看到这的，没看到这的小伙伴们都天天开心😎

还原当时情景🔄️​

AI 娘神力​

解决方案​

创建父仓库​

本地操作流程​

父仓库代码自动提交​