如何托管无敏感历史的公开Git仓库并与私有库同步？

核心思路：创建干净的公开分支，通过Cherry-pick实现双向增量同步 #

因为git checkout --orphan会导致历史完全分叉，shallow clone无法推送，所以我们用彻底清理敏感历史的干净分支作为公开仓库的基础，再通过Cherry-pick在私有/公开分支间同步增量提交，既隐藏敏感历史，又能双向同步。

步骤1：生成无敏感历史的公开分支 #

1. 克隆私有仓库的本地完整副本（操作本地，不影响远程私有库）：

   git clone git@your-private-repo-url.git private-repo
   cd private-repo
   

2. 用git filter-repo彻底清理敏感历史（官方推荐替代filter-branch的工具，Git 2.22+自带）：
   • 如果要删除特定敏感文件/目录：

     git filter-repo --path sensitive-dir/ --path secret-config.json --invert-paths
     

   • 如果要删除某条特定提交（假设提交哈希是abc123）：

     git filter-repo --commit-callback 'if commit.hexsha == b"abc123": skip()'
     

   • 清理完成后，你会得到一个只有干净历史的仓库，当前HEAD内容和原私有库一致。
3. 创建专门的公开分支：

   git checkout -b public-main
   

步骤2：配置双向同步的远程与工作流 #

1. 添加公开仓库的远程地址：

   git remote add public git@your-public-repo-url.git
   

2. 将干净的public-main推送到公开仓库作为主分支：

   git push public public-main:main
   

从私有仓库同步到公开仓库

当私有仓库有新提交时，按以下步骤同步：

1. 拉取私有仓库最新代码：

   git checkout main
   git pull origin main
   

2. 切换到公开分支，将私有分支的新增提交Cherry-pick过来：

   git checkout public-main
   # 假设私有分支新增了2个提交，用范围指定；如果是单个提交直接写哈希
   git cherry-pick main~2..main
   

3. 处理可能的冲突（如果有），然后推送到公开仓库：

   git push public public-main:main
   

从公开仓库同步到私有仓库

当公开仓库有PR或外部提交时，按以下步骤同步：

1. 拉取公开仓库最新代码：

   git checkout public-main
   git pull public main
   

2. 切换到私有分支，将公开分支的新增提交Cherry-pick过来：

   git checkout main
   git cherry-pick public-main~1..public-main  # 假设新增1个提交，按需调整范围
   

3. 处理冲突（如果有），然后推送到私有仓库：

   git push origin main
   

注意事项 #

• 永远不要将私有分支和公开分支合并，避免敏感历史泄露到公开仓库。
• 如果同步频率高，可以写简单的shell脚本自动化Cherry-pick和推送流程，减少手动操作。
• git filter-repo操作会重写历史，所以操作前务必备份私有仓库的本地副本，避免误操作。

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