如何将GitLab仓库的public子文件夹同步至GitHub并支持双向贡献？

工具适用性分析 #

• GitLab仓库镜像：只能同步整个仓库，没法单独抽离public文件夹，直接排除。
• Git Submodule：适合把独立仓库作为子模块嵌入，但你的需求是把现有仓库的子目录导出成独立开源仓，反向同步会很别扭，还要调整内部开发结构，不推荐。
• Git Subtree：完美匹配你的需求——既能把foo的public目录推送到baa，也能把baa的外部贡献拉回foo，不需要拆分原有仓库，对内部开发影响最小，是首选方案。

具体实现步骤 #

1. 初始关联两个仓库 #

在内部GitLab的foo仓库本地目录，添加GitHub的baa作为远程仓库：

git remote add github-baa git@github.com:你的组织名/baa.git

首次把public目录推送到baa完成初始化：

git subtree push --prefix=public github-baa main

（如果baa的主分支是master，替换成对应分支名）

2. 自动化同步（需求a）：GitLab CI配置 #

在foo根目录创建.gitlab-ci.yml，主分支有变更时自动同步public到baa：

stages:
  - sync

sync-public-to-github:
  stage: sync
  only:
    - main  # 只监听主分支变更
  script:
    - git config --global user.name "GitLab CI Bot"
    - git config --global user.email "ci-bot@你的公司域名"
    - git remote add github-baa git@github.com:你的组织名/baa.git
    - git subtree push --prefix=public github-baa main
  tags:
    - 你的Runner标签  # 指定可用的CI运行器

注意：要给GitLab Runner配置能访问GitHub的SSH密钥，把密钥添加到baa仓库的Deploy Keys并开启写入权限。

3. 外部贡献回流（需求b） #

外部用户在baa提交PR并合并后，在内部foo仓库拉取变更到public目录：

git subtree pull --prefix=public github-baa main --squash

--squash会把baa的多次提交压缩成一个，避免污染foo的提交历史，不需要的话可以去掉。拉取后提交到foo即可。

如果需要频繁处理，也可以把这个做成手动触发的CI任务：

sync-from-github:
  stage: sync
  when: manual  # 手动触发
  script:
    - git config --global user.name "GitLab CI Bot"
    - git config --global user.email "ci-bot@你的公司域名"
    - git remote add github-baa git@github.com:你的组织名/baa.git
    - git subtree pull --prefix=public github-baa main --squash
    - git push origin main
  tags:
    - 你的Runner标签

4. 手动同步（需求c） #

合规审核完成后，直接在本地或服务器执行命令即可：

• 从foo推public到baa：

git subtree push --prefix=public github-baa main

• 从baa拉变更到foo的public：

git subtree pull --prefix=public github-baa main --squash

备选方案：拆分公私项目 #

如果觉得subtree不够直观，可以彻底拆分：

1. 新建内部GitLab仓库foo-core，存放private文件夹及核心代码；
2. 把原public文件夹单独作为GitHub的baa仓库，同时在内部GitLab托管一份镜像；
3. 在foo-core里用submodule引用内部的baa仓库，方便内部开发；
4. 配置内部baa的CI同步到GitHub，外部贡献合并到GitHub后再同步回内部，最后在foo-core更新submodule。
   这个方案适合长期维护且公私边界清晰的场景，但需要调整现有开发流程。

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