Git中干净同步上游分支新变更到特性分支的Rebase指南

你之前使用的git pull origin upstream-branch会生成额外的合并提交，让提交树变得杂乱。而git rebase能实现你想要的线性、干净的提交结构，以下是针对该场景的完整操作指南：

1. 同步本地上游分支 #

首先确保本地的上游分支和远程仓库保持一致，避免基于过时的版本变基：

# 切换到上游分支（替换成你的上游分支名，比如main/develop）
git checkout upstream-branch
# 拉取远程最新变更
git pull origin upstream-branch

2. 切换回特性分支 #

git checkout feature-branch

3. 执行变基操作 #

将特性分支的所有提交重新基于最新的上游分支：

git rebase upstream-branch

这一步会把特性分支的提交逐个“搬移”到上游分支的最新提交之后，最终形成你期望的线性提交树。

处理变基冲突 #

如果变基过程中遇到代码冲突，Git会暂停操作并提示冲突文件：

1. 打开冲突文件，手动解决冲突（找到<<<<<<<、=======、>>>>>>>标记的代码块，保留正确逻辑）
2. 标记冲突已解决：

git add <冲突文件名>

3. 继续完成变基：

git rebase --continue

如果中途想放弃变基，回到操作前的状态，执行：

git rebase --abort

推送更新后的特性分支（仅适用于已推送到远程的分支） #

因为变基重写了提交历史，常规推送会被拒绝，需要使用强制推送。推荐用--force-with-lease，它会检查远程分支是否有你未同步的新提交，避免误覆盖他人修改：

git push origin feature-branch --force-with-lease

提交树对比 #

变基前

feature branch  o--o--o--o
                   /
upstream commits  /  new changes
--o--o--o--o--o--o--o--o

变基后

feature branch    o--o--o--o
                         /
upstream commits        /
--o--o--o--o--o--o--o--o

注意事项 #

• 禁止在公共分支（如main、develop）上执行变基，这会修改公共提交历史，影响所有协作成员
• 仅在特性分支为个人使用、未与他人共享时，放心使用变基
• 若特性分支已和团队共享，变基前务必和团队沟通确认

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