夏夜流萤 bilibili - 乐格不是食物
欢迎来到我的博客！
716 字
4 分钟
GitHub 公开仓库与私有仓库的同步管理实践
TIP在使用静态博客框架的时候，我们常会遇到这样的场景：需要维护一个公开仓库作为基础框架，同时保留一个私有仓库用于构建发布博客，且希望私有仓库能随时同步公开仓库的更新。这个需求看似简单，实际操作中却可能遇到各种 Git 冲突和分支问题。本文将结合我的实操经历，详细分享这一过程中的配置方法、遇到的问题及解决方案。
为什么需要这样做？
我需要维护两个仓库：
-
公开仓库（
Firefly）：作为基础项目框架，包含通用功能和公共更新 -
私有仓库（
my-blog）：基于公开仓库的个人博客，包含私有内容和网站配置
核心需求是：私有仓库能选择性同步公开仓库的更新，既保留网站配置，又能及时获取基础框架的 bug 修复和功能升级。这种模式的优势在于：
-
公开仓库专注通用功能开发及个性化需求和公共更新
-
保护私有仓库里的网站配置及文章不被公开
操作步骤与遇到的问题及解决方案
一、仓库初始化与关联配置
1. 关联两个仓库
首先需要将私有仓库与公开仓库关联，通过添加远程源（upstream 通常用于表示上游仓库）实现：
\# 克隆私有仓库到本地
git clone https://github.com/CuteLeaf/my-blog.git
cd my-blog
\# 添加公开仓库作为上游源
git remote add upstream https://github.com/CuteLeaf/Firefly.git
\# 验证关联结果
git remote -v此时会显示两个远程源：origin（私有仓库）和 upstream（公开仓库）。
二、首次同步公开仓库更新
1. 拉取公开仓库分支
git fetch upstream该命令会拉取公开仓库的所有分支信息（如 upstream/master）。
2. 合并公开仓库分支
git merge upstream/master如果出现报错：fatal: refusing to merge unrelated histories 一般会出现在首次合并时，因为两个仓库的提交历史不同。 Git 认为它们是完全独立的项目，拒绝合并。
解决方案：使用 --allow-unrelated-histories 参数强制首次合并，请注意，操作会完全覆盖本地修改：
git merge upstream/master --allow-unrelated-histories三、合并冲突的处理
强制合并后，出现大量文件冲突（add/add 类型）：
Auto-merging .gitignore
CONFLICT (add/add): Merge conflict in .gitignore
...（多个文件冲突）这时候我们要手动解决冲突
1.打开冲突文件，寻找冲突标记：
<<<<<<< HEAD # 私有仓库内容
...
\======= # 分隔线
... # 公开仓库内容
\>>>>>>> upstream/master2.根据需求编辑：保留私有内容、保留公开内容或合并两者
3.标记为已解决并提交：
git add .
git commit -m "解决合并冲突，整合公开仓库更新"
git push origin master赞助支持
如果这篇文章对你有帮助，欢迎赞助支持！
GitHub 公开仓库与私有仓库的同步管理实践
https://blog.cuteleaf.cn/posts/practical-skills/github-public-private-sync/ 最后更新于 2025-09-09，距今已过 88 天
部分内容可能已过时
