git rebase的用法

git

git rebase 是什么？

git rebase 是一种 Git 命令，用于将一个分支的更改重新应用到另一个分支的基础上。它的核心是将当前分支的提交历史移动到目标分支的最新状态之上，生成一个更线性的历史记录。

与 git merge 不同，rebase 不会创建合并提交，而是重写历史。

基本用法

git checkout <要更新的分支>
git rebase <目标分支>

• 效果：将 <目标分支> 的最新提交作为基础，把 <要更新的分支> 的提交逐一应用上去。

场景中使用 git rebase

比如有原来有3个分支，1分支logo是小明的，2分支的logo是小红的，3分支的logo是小刚的；但是他们的功能都是一样的，只是logo不同，但是代码修复了，每个人都需要更新最新的代码，保留自己的logo。

所以：

• 三个分支（branch-xiaoming、branch-xiaohong、branch-xiaogang），功能代码相同，仅 logo 不同。
• 代码修复后，三个分支都需要同步更新，但保留各自的 logo。

假设有一个核心分支 core 包含共享代码，修复也在 core 上完成，我们可以用 git rebase 将修复应用到个性化分支。

示例步骤

1. 初始化分支

   • core 分支包含共享代码（无 logo）：

     git checkout -b core
     echo "Shared code" > core-function.js
     git add core-function.js
     git commit -m "Initial core code"
     git push origin core
     

   • 创建个性化分支并添加 logo：

     git checkout core
     git branch branch-xiaoming
     git checkout branch-xiaoming
     cp xiaoming-logo.png logo.png
     git add logo.png
     git commit -m "Add Xiaoming's logo"
     git push origin branch-xiaoming
     

     （为小红、小刚类似操作）

2. 在 core 上修复代码

   • 修复 bug：

     git checkout core
     echo "Bug fix" >> core-function.js
     git add core-function.js
     git commit -m "Fix bug in core function"
     git push origin core
     

3. 用 rebase 更新个性化分支

   • 更新 branch-xiaoming：

     git checkout branch-xiaoming
     git rebase core
     

   • 效果：
     • Git 会先找到 branch-xiaoming 和 core 的共同祖先。
     • 将 core 的新提交（"Fix bug in core function"）作为新基础。
     • 然后将 branch-xiaoming 的提交（"Add Xiaoming's logo"）重新应用上去。
   • 推送更新：

     git push origin branch-xiaoming --force
     

     （因为 rebase 重写了历史，需要用 --force 推送）
   • 对 branch-xiaohong 和 branch-xiaogang 重复以上操作。

4. 结果

   • 每个分支的提交历史变为：

     core: Initial core code -> Fix bug in core function
     branch-xiaoming: Initial core code -> Fix bug in core function -> Add Xiaoming's logo
     

git rebase 的优点

1. 线性历史：
   • 相比 git merge 的合并提交，rebase 让提交历史更简洁，像是一条直线。
   • 示例历史：

     * Add Xiaoming's logo
     * Fix bug in core function
     * Initial core code
     

2. 干净同步：
   • 直接将 core 的修复应用到个性化分支，避免额外的合并节点。
3. 保留个性化内容：
   • 因为 logo 文件只在个性化分支上有提交，rebase 不会覆盖它们，除非 core 修改了同一个文件（这时会有冲突）。

git rebase 的缺点与注意事项

1. 冲突处理：
   • 如果 core 的修复和个性化分支的改动冲突（比如都改了 core-function.js），需要手动解决：

     git rebase core
     # 冲突发生，解决后
     git add <冲突文件>
     git rebase --continue
     

2. 重写历史：
   • rebase 改变了提交历史，已推送的分支需要用 git push --force，可能影响协作（如果多人共用分支）。
3. 操作复杂性：
   • 相比 merge 的直观性，rebase 对新手不友好，误操作可能导致历史混乱。

与之前方案的对比

方案	优点	缺点	适用性
cherry-pick	简单，选择性应用特定提交	频繁更新时手动操作多	小规模、临时更新
merge	直观，保留历史，协作友好	历史有合并节点，可能不简洁	长期维护、团队协作
subtree	核心代码独立，隔离性强	设置复杂，需额外仓库	模块化管理
rebase	线性历史，干净同步	重写历史，冲突需手动处理	追求简洁历史、单人维护

在你的场景中

• merge vs rebase：
  • merge：会在每个分支上多一个合并提交（"Merge branch 'core' into branch-xiaoming"），历史更复杂但更安全。
  • rebase：历史线性，像所有提交都发生在同一条线上，但需要 --force 推送。
• 适用性：
  • 如果你独自维护这三个分支，且追求简洁历史，rebase 是个好选择。
  • 如果多人协作，或者你不介意合并节点，merge 更稳妥。

推荐方案：git rebase

结合你的问题，我建议用 rebase 的方案如下：

实现流程

# 确保 core 分支最新
git checkout core
git pull origin core

# 修复代码
echo "Bug fix" >> core-function.js
git add core-function.js
git commit -m "Fix bug"
git push origin core

# 更新小明分支
git checkout branch-xiaoming
git rebase core
git push origin branch-xiaoming --force

# 更新小红分支
git checkout branch-xiaohong
git rebase core
git push origin branch-xiaohong --force

# 更新小刚分支
git checkout branch-xiaogang
git rebase core
git push origin branch-xiaogang --force

处理冲突（如果有）

若 core-function.js 在个性化分支也有改动：

git rebase core
# 冲突发生，编辑文件保留 logo 和修复
git add core-function.js
git rebase --continue
git push origin branch-xiaoming --force

总结

• 为什么推荐 rebase：它能保持历史线性，适合你描述的场景（功能相同、仅 logo 不同），每次更新就像在各自分支上“续写”核心代码。
• 注意事项：用 --force 推送时，确保团队知晓（若有协作）。
• 替代选择：若不想重写历史，用 merge 更简单。