跟踪上游主题 - Limitlm的博客

Git 工作流方案对比#

方案一：直接合并#

1
git fetch upstream
2
git merge upstream/master

优点：

操作简单直观，学习成本低
保留完整的合并历史，便于追溯
冲突只需解决一次

缺点：

会产生额外的合并提交，历史图可能变得”杂乱”
如果频繁同步，提交历史会包含大量合并节点

方案二：变基合并#

1
git fetch upstream
2
git rebase upstream/master

优点：

保持线性历史，提交图清晰美观
自定义修改始终在最新的上游代码之上

缺点：

⚠️ 重大风险：如果 custom 分支已推送到远程，rebase 会改写历史，可能导致协作问题
每次同步上游时，如果上游有新提交与修改重叠，需要重复解决冲突
对于配置文件这类频繁修改的文件，冲突处理成本较高

方案三：双分支策略（推荐 ⭐）#

1
分支结构：
2
master     → 跟踪 upstream/master（纯净的上游代码）
3
custom     → 你的个性化配置分支

工作流程：

1
# 初始设置
2
git remote add upstream <原始仓库URL>
3
git remote set-url origin <你的私有仓库URL>
4

5
# 同步上游更新
6
git checkout master
7
git fetch upstream
8
git merge upstream/master --ff-only
9
git push origin master
10

11
# 将更新合并到 custom 分支
12
git checkout custom
13
git merge master
14
git push origin custom

优点：

历史记录清晰：master 始终等于上游，custom 包含你的修改
冲突隔离：冲突只在 custom 分支处理，不影响纯净的上游跟踪
回滚方便：如果某次同步出问题，可以重置 master 重新同步
便于查看差异：git diff master..custom 清晰显示所有自定义修改

缺点：

需要维护两个分支
操作步骤稍多

方案综合对比#

维度	方案一	方案二	方案三 (双分支)
操作复杂度	⭐⭐⭐⭐⭐ 简单	⭐⭐⭐ 中等	⭐⭐⭐⭐ 较简单
冲突处理	一次解决	可能重复解决	一次解决
历史清晰度	⭐⭐⭐ 一般	⭐⭐⭐⭐⭐ 最佳	⭐⭐⭐⭐ 清晰
回滚能力	⭐⭐⭐ 一般	⭐⭐ 较差	⭐⭐⭐⭐⭐ 最佳
适合场景	偶尔同步	未推送的分支	长期维护项目

当前配置#

远程仓库配置#

1
git remote -v

当前配置：

origin → 私有仓库：https://github.com/limitlm/Blog-Firefly.git
upstream → 上游仓库：https://github.com/CuteLeaf/Firefly.git

分支结构#

master：跟踪上游代码（纯净的原始主题）
custom：个性化配置分支（日常开发使用）

日常使用指南#

1. 在 custom 分支进行修改#

1
git checkout custom
2
# 修改配置文件...
3
git add .
4
git commit -m "修改个人配置"
5
git push origin custom

2. 同步上游更新#

1
# 切换到 master 分支，同步上游
2
git checkout master
3
git fetch upstream
4
git merge upstream/master --ff-only
5
git push origin master
6

7
# 将更新合并到 custom 分支
8
git checkout custom
9
git merge master
10
git push origin custom

3. 查看自定义修改#

1
git diff master..custom

4. 查看当前状态#

1
git status
2
git branch -a

重要结论#

对于长期维护个人博客主题配置的场景，双分支策略是最优解，原因如下：

博客主题会长期使用，需要多次同步上游更新
配置文件易冲突，双分支便于隔离冲突
便于回滚，如果某次上游更新破坏了配置，可以轻松回退
历史清晰，随时可以看到相对于原始主题做了哪些修改

参考链接#

原始主题仓库：https://github.com/CuteLeaf/Firefly
私有仓库：https://github.com/limitlm/Blog-Firefly

音乐

音乐

Git 工作流方案对比#

方案一：直接合并#

方案二：变基合并#

方案三：双分支策略（推荐 ⭐）#

方案综合对比#

当前配置#

远程仓库配置#

分支结构#

日常使用指南#

1. 在 custom 分支进行修改#

2. 同步上游更新#

3. 查看自定义修改#

4. 查看当前状态#

重要结论#

参考链接#

支持与分享

音乐

目录