Git rebase 分支：如何一步一步安全地 rebase

要对分支进行变基，请获取、切换到该分支并将其重播到新的基础上：`git fetch origin`、`git switch topic`、`git rebase origin/main`。 Git 将分支自己的提交放在一边，将分支移动到 origin/main 的顶端，然后一次重新应用一个提交。历史记录保持一条直线，没有合并提交。每个重播的提交都会获得一个新的哈希值，因此您已经推送的分支之后需要 git push --force-with-lease。

git rebase 对分支做了什么？

假设 topic 有两个自己的提交，而 main 自分支启动以来已经获得了三个提交。变基更新该起点，而不将 main 合并到您的分支中：

# before
A---B---C---D---E   origin/main
     \
      F---G         topic

# after git rebase origin/main
A---B---C---D---E   origin/main
                 \
                  F'---G'   topic

F' 和 G' 包含与 F 和 G 相同的更改和消息，但它们是具有新哈希值的新提交，因为它们的父级发生了更改。从同一起点进行合并将保留两条线，并添加一个具有两个父项的提交。关于合并与变基 的课程在一张图表上显示了两者。

如何逐步安全地变基分支？

首先检查，保留旧提示，重播，然后测试。前三个命令不重写任何内容：

# 1. update origin/main, your files stay as they are
git fetch origin

# 2. list the commits Git will replay
git log --oneline origin/main..topic

# 3. keep a name on the old tip
git branch topic-backup topic

# 4. replay
git switch topic
git rebase origin/main

如果列表中有您无法识别的提交，请停止在步骤 2 处，因为这意味着分支并未从您认为的位置开始。当变基结束时，运行 git status 以确认其完成，然后运行测试。没有冲突的变基仍然会破坏行为。

每次都命名基地。裸的 git rebase 使用分支的上游，通常是 origin/topic 而不是 main。要移动从另一个功能分支开始的分支，请将旧基础也命名为：git rebase --onto main old-base topic。关于重新确定未发表工作的基准 的课程在真实图表上练习了这一点。

如何解决变基期间的冲突？

Git 一次应用一个提交，因此它可以多次停止，即使是在同一行中。仅修复 Git 停止的提交，因为后面的提交尚未应用：

# edit the file and remove the conflict markers, then
git add path/to/file
git rebase --continue

如果您经常重播相同的冲突，git config rerere.enabled true 会记录您的解决方案并重复使用它。检查每个重用的结果，因为昨天的答案在今天的代码中可能是错误的。关于继续、跳过和中止 的课程将介绍每种情况，而如何解决合并冲突 则涵盖阅读标记。

在推送之前如何检查变基？

在其他人看到之前将旧系列与新系列进行比较：

# old and new commits, matched pair by pair
git range-diff origin/main topic-backup topic

# everything the branch adds to main, as one diff
git diff origin/main...topic

# the shape of the history
git log --graph --oneline --decorate origin/main topic

git range-diff 显示冲突解决方案更改补丁的时间或提交丢失的时间。编译后的代码仍然可以隐藏删除的测试或更改的条件，这就是您捕获它的地方。

如何撤消变基？

当它运行时，使用 git rebase --abort。完成后，将分支移回旧尖端。首先检查 git status，因为 --hard 会丢弃未提交的更改：

git reset --hard topic-backup

# no backup? find the old tip in the reflog
git reflog show topic
git reset --hard <old-tip-hash>

撤消重置、变基或提交 指南更深入地介绍了引用日志。

如何推送变基后的分支？

正常的推送被拒绝，因为远程分支仍然保留旧的提交，并且 Git 看到非快进更新。检查您要更换的内容，然后通过租约推送：

git fetch origin
git log --oneline topic..origin/topic
git push --force-with-lease origin topic

该 git log 应仅列出您的旧提交。其他的事情都是队友的工作，所以停下来先把它带进来。仅当远程分支仍在上次提取时看到的位置时，--force-with-lease 才会替换远程分支，而普通的 --force 没有此类检查。后台获取会更新该值，因此脚本可以将其期望的提交命名为：git push --force-with-lease=topic:<expected-hash> origin topic。

我应该重新设置或合并这个分支吗？

分支变基 指南提供了所有选项，而 强制推送带租约 涵盖了推送。要一路压缩、改写或重新排序，请阅读 GUI 中的交互式变基。