如何在GitHub创建无历史公开分支并实现与私有仓库定期合并？

是否必须设置为独立GitHub项目？ #

是的，必须用独立的公开仓库——GitHub没有分支级别的权限隔离，仓库一旦标记为私有，所有分支都会保持私有状态，无法单独将某个分支设为公开。所以要实现“公开可见且无提交历史”的需求，只能创建独立的PUBLIC公开仓库。

有没有其他替代方式？ #

不存在“私有仓库里单独公开某个分支”的官方方案，强行通过非官方手段（比如镜像分支到外部再导入）反而会增加维护风险，不如直接用独立仓库更稳妥。

定期合并PRIVATE到PUBLIC的简洁方案 #

手动合并步骤（适合低频更新） #

1. 克隆PUBLIC仓库到本地：

   git clone https://github.com/your-username/PUBLIC.git
   cd PUBLIC
   

2. 添加PRIVATE仓库为远程源：

   git remote add private https://github.com/your-username/PRIVATE.git
   

3. 拉取PRIVATE的最新主分支代码：

   git fetch private main
   

4. 清空PUBLIC的提交历史，重置为PRIVATE的最新状态：

   git reset --hard private/main
   git checkout --orphan temp-branch
   git add -A
   git commit -m "发布最新版本"
   git branch -D main
   git branch -m main
   

5. 强制推送到PUBLIC仓库：

   git push -f origin main
   

   （注意：强制推送会覆盖PUBLIC现有内容，操作前确认无误）

自动化合并方案（适合高频更新） #

用GitHub Actions实现自动同步，步骤如下：

1. 在PRIVATE仓库中创建/.github/workflows/sync-to-public.yml文件，内容如下：

   name: Sync to Public Repository
   on:
     push:
       branches: [ main ] # PRIVATE主分支有推送时触发
     workflow_dispatch: # 允许手动触发
   
   jobs:
     sync:
       runs-on: ubuntu-latest
       steps:
         - name: Checkout Private Repository
           uses: actions/checkout@v4
           with:
             fetch-depth: 0 # 获取完整提交历史
   
         - name: Push to Public Repository
           run: |
             git remote add public https://${{ secrets.PUBLIC_REPO_TOKEN }}@github.com/your-username/PUBLIC.git
             git checkout --orphan temp-branch
             git add -A
             git commit -m "Auto-sync: $(date +'%Y-%m-%d %H:%M:%S')"
             git push -f public temp-branch:main
   

2. 在GitHub的「Settings → Secrets and variables → Actions」中，添加名为PUBLIC_REPO_TOKEN的密钥，值为拥有PUBLIC仓库推送权限的个人访问令牌（PAT）。

此后，每次PRIVATE主分支有更新时，会自动同步最新代码到PUBLIC仓库，且PUBLIC始终仅保留一条提交记录。

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