跨平台Git使用策略：BitBucket转GitHub公开发布方案咨询

我们团队基于Git+BitBucket开展内部开发，拥有专属私有仓库，需定期将特定里程碑提交同步到GitHub作为公开版本，核心需求如下：

• 仅推送指定里程碑提交，不公开所有内部提交
• 排除指定目录/子目录，不纳入公开版本
• 保留有效提交历史与备注，但过滤掉与被排除目录相关的备注
• 支持将GitHub上的Pull Request合并回内部BitBucket仓库

Git原生功能可实现核心需求 #

借助Git的远程仓库管理、分支隔离与git filter-repo（官方推荐的历史重写工具），完全可以满足上述需求，具体操作流程如下：

1. 配置双远程仓库 #

本地克隆内部BitBucket仓库，添加GitHub公开仓库作为第二远程：

git clone <BitBucket内部仓库地址>
cd <仓库目录>
git remote add github <GitHub公开仓库地址>

2. 基于里程碑创建公开分支 #

每次发布公开版本时，从内部仓库的里程碑标签或目标提交创建独立的公开分支：

git checkout -b public-release <里程碑标签/提交哈希>

3. 清理非公开内容 #

使用git filter-repo完成两项清理：

• 移除指定目录：

git filter-repo --path <需排除目录1> --path <需排除目录2> --invert-paths

• 过滤提交备注：通过回调函数移除与被排除目录相关的备注内容，示例如下：

git filter-repo --message-callback "
import re
msg_str = msg.decode('utf-8')
# 替换或移除包含内部目录关键词的备注内容
return re.sub(r'\[内部目录相关关键词\].*', '', msg_str).encode('utf-8')
"

4. 推送至GitHub #

将处理后的公开分支推送到GitHub的目标分支（如main）：

git push github public-release:main

每次发布新里程碑时，重复步骤2-4即可，仅推送经过筛选的内容。

5. 同步GitHub PR至内部仓库 #

要将GitHub上的PR合并回BitBucket，可按以下步骤操作：

• 拉取GitHub上的PR分支到本地：

git fetch github pull/<PR编号>/head:pr-<PR编号>

• 切换到内部开发分支，合并PR分支（合并前务必完成代码审查）：

git checkout <内部开发分支>
git merge pr-<PR编号>

• 解决冲突后推回BitBucket内部仓库：

git push origin <内部开发分支>

注意事项 #

• 建议在独立的本地副本中处理公开分支，避免污染内部开发分支的提交历史
• git filter-repo会重写提交历史，操作前务必做好备份
• 若需自动化定期发布，可将上述步骤封装为脚本，结合CI/CD工具（如Jenkins、GitHub Actions）定时执行

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