如何将主Git仓库下的子文件夹设为独立可克隆仓库？

GitHub 情况 #

GitHub没有原生支持将主仓库内的子文件夹直接设为可单独克隆的独立仓库，必须先手动拆分出独立仓库，再通过自动化工具实现定期同步：

1. 拆分初始独立仓库
   使用git filter-repo（替代已废弃的git filter-branch）提取子文件夹的完整历史：

   # 克隆原仓库到本地
   git clone https://github.com/mybusiness/infrastructure.git
   cd infrastructure
   # 提取dev/infra-ansible文件夹并重命名为根目录，生成干净的仓库历史
   git filter-repo --path dev/infra-ansible/ --path-rename dev/infra-ansible/:./
   # 创建新的私有GitHub仓库，将拆分后的内容推送上去
   git remote add new-origin https://github.com/mybusiness/infra-ansible.git
   git push -u new-origin main
   

   重复此步骤处理dev/app-build/等其他文件夹。

2. 设置定期同步
   利用GitHub Actions创建定时工作流，每天/每周从原仓库拉取更新，重新过滤后推送到子仓库。示例工作流（.github/workflows/sync.yml）：

   name: Sync Subfolder to Repo
   on:
     schedule:
       - cron: '0 0 * * 0' # 每周日凌晨同步
     workflow_dispatch: # 手动触发
   
   jobs:
     sync:
       runs-on: ubuntu-latest
       steps:
         - name: Clone original repo
           uses: actions/checkout@v4
           with:
             repository: mybusiness/infrastructure
             fetch-depth: 0
   
         - name: Filter and push to sub repo
           run: |
             git filter-repo --path dev/infra-ansible/ --path-rename dev/infra-ansible/:./
             git remote add sub-repo https://${{ secrets.GH_PAT }}@github.com/mybusiness/infra-ansible.git
             git push -f sub-repo main
   

   注意：需要在GitHub仓库设置中创建GH_PAT（带有仓库读写权限的个人访问令牌）作为 secrets。

GitLab 情况 #

GitLab同样没有原生的"子文件夹直接转为独立仓库"功能，但可以通过GitLab CI/CD或项目镜像结合路径过滤实现类似需求：

1. 拆分初始独立仓库
   步骤和GitHub一致，使用git filter-repo拆分后推送到新的GitLab私有仓库。

2. 自动同步方案

   • GitLab CI/CD定时同步：创建.gitlab-ci.yml文件，设置定时流水线，定期从原仓库拉取更新并同步到子仓库：

     sync_subfolder:
       schedule:
         - cron: '0 0 * * 0' # 每周日凌晨同步
       script:
         - git clone --depth 0 https://gitlab.com/mybusiness/infrastructure.git
         - cd infrastructure
         - git filter-repo --path dev/infra-ansible/ --path-rename dev/infra-ansible/:./
         - git remote add sub-repo https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.com/mybusiness/infra-ansible.git
         - git push -f sub-repo main
       tags:
         - docker
     

   • 项目镜像+路径重写：GitLab的项目镜像功能支持路径过滤，但需要结合自定义脚本实现，本质和CI方案类似，核心还是通过过滤子文件夹内容后推送。

关键说明 #

• 无论GitHub还是GitLab，都无法直接让主仓库内的子文件夹成为可单独克隆的独立仓库，必须先拆分出独立仓库实例。
• 同步过程中如果原仓库和子仓库有冲突（比如子仓库有独立修改），需要提前制定冲突处理规则，避免覆盖重要变更。

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