【新手村专属】Git使用基础教程：Git Rebase 使用分享

AUTOSAR的小白

已于 2025-05-06 02:35:32 修改

阅读量950

点赞数 28

分类专栏： git使用文章标签： git

于 2025-05-06 02:25:54 首次发布

本文链接：https://blog.csdn.net/m0_57446237/article/details/147725261

版权

git使用专栏收录该内容

2 篇文章

订阅专栏

什么是 Git Rebase？

在深入了解 Git Rebase 的实际应用前，让我们先明确它的概念。

Rebase（变基）是 Git 中的一种操作，它可以将一个分支的更改"移植"到另一个分支上。与 merge（合并）不同，rebase 会重写提交历史，创建一个更加线性和整洁的提交记录。

简单来说：

Merge：创建一个新的"合并提交"，保留完整历史，但可能使历史变得复杂
Rebase：重新应用提交，创建线性历史，但改变了提交的SHA-1值

下面这张图展示了 merge 和 rebase 的区别：

# Merge 示例 (创建合并提交)
      A---B---C feature
     /         \
D---E---F---G---H main

# Rebase 示例 (线性历史)
              A'--B'--C' feature
             /
D---E---F---G main

Git Rebase 的主要使用场景

在日常开发中，rebase 主要有两个核心应用场景：

1. 保持特性分支与主分支同步

将基线分支（如 main）的最新更改同步到开发分支，避免后期合并时出现大量冲突。

为什么这很重要？

及时发现冲突：小而频繁的 rebase 比一次大的 merge 更容易处理
确保代码在最新环境下工作：你的功能始终基于最新代码开发
简化 PR/MR 流程：当你准备提交 PR 时，不会有大量的合并冲突需要处理

基本操作流程：

# 1. 查看当前分支
git branch
# 输出示例:
# * feature-branch
#   main

# 2. 更新主分支
git checkout main
git pull

# 3. 切回开发分支并执行 rebase
git checkout feature-branch
git rebase main

# 4. 如有冲突，解决后继续
git add <解决冲突的文件>
git rebase --continue

实际操作示例：

> git branch
* feature-branch
  main

> git checkout main
Switched to branch 'main'
Your branch is up to date with 'origin/main'.

> git pull
Already up to date.

> git checkout feature-branch
Switched to branch 'feature-branch'
Your branch is up to date with 'origin/feature-branch'.

> git rebase main
Current branch feature-branch is up to date.

# 如果出现冲突
# 1. 解决冲突文件
# 2. 标记为已解决
git add <冲突文件>
# 3. 继续 rebase 过程
git rebase --continue

处理长期分支与文件重叠情况：

当一个分支存在较长时间且与他人修改了相同文件时，rebase 可能会变得复杂。以下是处理这种情况的有效策略：

# 1. 查看特定文件的提交历史
git log --oneline -- <file-path>

# 2. 找到合适的起点进行交互式变基
git rebase -i <commit-hash>

# 3. 解决冲突
git add .
git rebase --continue

# 4. 完成后推送到远程
# 注意: 强制推送要谨慎，确保你了解其影响
git push --force-with-lease origin feature-branch

2. 整理提交历史

在提交代码前，将多个小提交合并为一个或几个逻辑完整的提交，保持提交历史的清晰和有意义。

为什么需要整理提交历史？

提高代码审查效率：审查者可以更容易理解变更的整体意图
简化版本追踪：每个提交代表一个完整的功能或修复
便于回滚操作：如果需要回滚，可以回滚到特定功能的完整实现

使用场景：

在提交 PR/MR 前整理零碎的提交
为相关的修改创建逻辑上连贯的提交
清理包含错误或不必要信息的提交信息

交互式 rebase 操作：

交互式 rebase 是整理提交历史的强大工具，允许你重排、合并或删除提交。

# 交互式 rebase 最近的 n 个提交
git rebase -i HEAD~<n>

# 或从特定提交开始
git rebase -i <commit-hash>

可用的交互式命令：

pick：保留该提交
reword：修改提交信息
edit：暂停 rebase 以修改提交内容
squash：将提交合并到前一个提交，保留两者的提交信息
fixup：将提交合并到前一个提交，丢弃当前提交信息
drop：删除该提交

实际操作示例：

假设我们有三个相关的提交，想要合并成一个完整的功能提交：

> git log --oneline
abc1234 (HEAD -> feature-branch, origin/feature-branch) 添加新功能3
def5678 添加新功能2
ghi9012 添加新功能1

> git rebase -i HEAD~3
# 编辑器打开，显示如下内容:
pick ghi9012 添加新功能1
pick def5678 添加新功能2
pick abc1234 添加新功能3

# 修改为 (将后两个提交合并到第一个):
pick ghi9012 添加新功能1
squash def5678 添加新功能2
squash abc1234 添加新功能3

# 保存并关闭，编辑器再次打开以编辑合并的提交信息:
# 编辑为一个有意义的提交信息
完成新功能开发

# 保存后完成 rebase
> git push --force-with-lease origin feature-branch

Git Rebase 的最佳实践

要安全高效地使用 rebase，请遵循以下最佳实践：

频繁同步基线分支 - 定期进行 rebase 以减少冲突规模
使用 --force-with-lease 而非 -f - 这是一种更安全的强制推送方式，可以避免意外覆盖他人提交
不要对已发布的公共分支执行 rebase - 仅对个人开发分支使用，避免干扰他人工作
解决冲突前先理解变更 - 确保您理解所有冲突的上下文，不要盲目解决
在本地测试 rebase 后的代码 - 确保功能正常工作后再推送

常见问题与解决方案

如何处理 rebase 过程中的冲突？

当 Git 无法自动合并变更时，会产生冲突。处理步骤：

查看冲突文件 (git status)
编辑冲突文件，解决冲突部分
将解决的文件标记为已解决 (git add <file>)
继续 rebase 过程 (git rebase --continue)

如何中断一个进行中的 rebase？

如果 rebase 过程太复杂或你想重新开始：

git rebase --abort

这会恢复到 rebase 开始前的状态。

如何跳过特定提交中的冲突？

如果某个提交的冲突太复杂，你可以选择跳过：

git rebase --skip

注意：这会丢弃当前正在应用的提交。

推送 rebase 后的分支时出错怎么办？

rebase 后，你需要使用强制推送。推荐使用：

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

这比简单的 --force 更安全，它会在远程分支有你不知道的更改时拒绝推送。

总结

Git rebase 是一个强大但需要谨慎使用的工具。它能帮助你保持代码库的整洁和可维护性，但也可能导致历史重写的问题。遵循本文的最佳实践，你可以安全地利用 rebase 的强大功能，提高你的 Git 工作流效率。

Git Rebase 命令速查表

以下是本文涉及的所有 Git rebase 相关命令的快速参考：

基本 rebase 操作

命令	描述
`git rebase <base-branch>`	将当前分支变基到指定基础分支
`git rebase -i HEAD~<n>`	交互式变基最近的 n 个提交
`git rebase -i <commit-hash>`	从指定提交开始交互式变基
`git rebase --onto <new-base> <old-base> <branch>`	将指定范围的提交变基到新基础

Rebase 过程控制

命令	描述
`git rebase --continue`	解决冲突后继续 rebase 过程
`git rebase --skip`	跳过当前正在应用的提交
`git rebase --abort`	中止整个 rebase 过程并恢复原状态

交互式 rebase 选项

选项	描述
`pick`	保留提交不做更改
`reword`	保留提交但修改提交信息
`edit`	暂停 rebase 以修改提交内容
`squash`	将提交合并到前一个提交，保留所有提交信息
`fixup`	将提交合并到前一个提交，丢弃当前提交信息
`drop`	完全删除提交

命令	描述
`git log --oneline`	查看简洁的提交历史
`git log --oneline -- <file-path>`	查看特定文件的提交历史
`git status`	查看工作区状态，包括冲突文件
`git add <file>`	标记冲突文件为已解决
`git push --force-with-lease origin <branch>`	安全地强制推送 rebase 后的分支

高级选项

命令	描述
`git rebase --autostash`	自动储藏未提交的更改并在 rebase 完成后恢复
`git rebase --strategy=<strategy>`	指定合并策略（如 recursive, ours）
`git rebase --no-ff`	不使用快进合并，保留所有提交
`git rebase --committer-date-is-author-date`	设置提交日期与作者日期相同

返回目录 ↑