# Git 交互式变基：优雅整理提交历史，告别杂乱 PR 记录

前言

日常开发中，我们总会遇到这种尴尬场景：开发功能时随手提交「修复拼写错误」「临时草稿 WIP」「删除打印日志」这类零碎提交，等到提 PR 合并代码时，杂乱的提交记录不仅观感极差，还会让代码评审人员难以梳理开发逻辑。

今天就给大家详解 Git 交互式变基 git rebase -i，手把手教你合并、修改、重排、拆分提交记录，把凌乱的开发提交梳理成干净规范的版本历史，轻松通过 PR 代码评审。

一、为什么要用交互式变基？

先看很多开发者真实的提交历史：

plaintext

matlab 复制代码

fix typo 修复拼写错误
WIP 临时开发草稿
fix typo again 再次改拼写
actually fixed it 真正修复问题
remove console.log 移除日志打印

短短一个功能，产生 5 条无效零碎提交。在团队 PR 评审中，这样的提交历史显得极不专业，也不利于后续追溯版本问题。

而 Git 交互式变基 就是为解决这个问题而生，它支持合并提交、修改提交备注、调整提交顺序、拆分大提交、删除无效提交，一键精简版本历史。

二、交互式变基基础用法

1. 基础命令

方式 1：整理最近 N 条提交

想要整理最近 5 次提交，执行：

bash

运行

css 复制代码

git rebase -i HEAD~5

方式 2：基于主分支整理当前分支

更常用的场景：整理从 main 主分支分叉后的所有提交：

bash

运行

css 复制代码

git rebase -i main

执行命令后，会自动打开系统默认编辑器，展示最近的提交列表，格式如下：

plaintext

matlab 复制代码

pick 1a2b3c4 fix typo
pick 5d6e7f8 WIP
pick 9g0h1i2 fix typo again
pick 3j4k5l6 actually fixed it
pick 7m8n9o0 remove console.log

下方还附带了所有操作指令说明，我们逐一拆解。

2. 核心指令详解

编辑器内自带 6 个核心命令，是交互式变基的核心：

pick(p) ：保留该提交，不做任何修改，默认选项
reword(r) ：保留提交代码，但修改提交备注信息
edit(e) ：保留提交，暂停变基流程，允许修改文件内容、拆分提交
squash(s) ：将当前提交合并到上一条提交，并保留两条提交的备注
fixup(f) ：和 squash 类似，合并到上一条提交，但舍弃当前提交备注
drop(d) ：直接删除这条提交，丢弃对应代码变更

三、实战常用操作教程

1. 合并多条零碎提交（最常用）

针对开头 5 条杂乱提交，我们只保留第一条，其余全部用 fixup 合并：修改编辑器内内容：

plaintext

matlab 复制代码

pick 1a2b3c4 fix typo
fixup 5d6e7f8 WIP
fixup 9g0h1i2 fix typo again
fixup 3j4k5l6 actually fixed it
fixup 7m8n9o0 remove console.log

保存退出编辑器后，Git 会自动把后 4 条提交全部合并到第一条，最终只生成一条干净的提交记录，完美精简历史。

2. 修改提交备注

如果提交备注写得随意，想重新规范化文案，使用 reword：

plaintext

sql 复制代码

pick 1a2b3c4 fix typo
reword 5d6e7f8 add user authentication

保存后会再次弹出编辑器，可重新编辑这条提交的备注，适合规范 feat/fix/docs 等标准化提交文案。

3. 调整提交顺序

开发时不小心提交顺序错乱，直接调换 pick 行的顺序即可：原顺序：

plaintext

csharp 复制代码

pick 1a2b3c4 add feature
pick 3j4k5l6 add tests

调整后：

plaintext

csharp 复制代码

pick 3j4k5l6 add tests
pick 1a2b3c4 add feature

保存后 Git 会自动重排提交历史，逻辑更清晰。

4. 拆分臃肿大提交

很多人习惯把多个功能写在一次提交里，不利于代码回滚和评审，用 edit 拆分：

标记提交为 edit

plaintext

sql 复制代码

edit 1a2b3c4 huge commit with multiple changes

保存退出后，执行命令撤回暂存：

bash

运行

perl 复制代码

git reset HEAD^

按需分批添加文件、拆分提交：

bash

运行

sql 复制代码

git add file1.js
git commit -m "feat: 新增功能A"
git add file2.js
git commit -m "feat: 新增功能B"

完成变基：

bash

运行

kotlin 复制代码

git rebase --continue

即可把一条大提交拆分成多条独立小提交。

四、重要禁忌：千万别乱 Rebase

交互式变基本质是重写 Git 版本历史，有一条铁律必须遵守：

✅ 安全操作 ：仅在未推送到远程的个人功能分支做变基，不会影响团队其他人。

bash

运行

css 复制代码

# 个人开发分支，未推送远程，安全
git rebase -i main

❌ 危险操作 ：绝对不要对已推送到远程的公共分支（main/develop） 做变基！

bash

运行

css 复制代码

# 禁止操作！公共主分支不要变基
git checkout main
git rebase -i HEAD~5

重写公共分支历史后，团队其他成员拉代码会出现大量冲突，严重破坏协作流程。

五、实用 Git 别名，提升效率

每次输长命令太麻烦，可以配置 Git 别名，编辑 ~/.gitconfig 文件，添加以下配置：

ini

ini 复制代码

[alias]
    # 交互式变基最近 N 条提交
    rb = "!f() { git rebase -i HEAD~$1; }; f"
    # 拉取最新main并交互式变基
    rbm = "!git fetch origin main && git rebase -i origin/main"

配置完成后，可简化命令使用：

bash

运行

bash 复制代码

git rb 5    # 交互式变基最近5条提交
git rbm     # 拉取远程main最新代码并变基整理

结语

Git 交互式变基不是高阶炫技，而是开发必备基本功。熟练掌握合并、改备注、调顺序、拆分提交这些操作，能让你的提交历史整洁规范，PR 评审更顺畅，也方便后续版本回溯和问题排查。只要牢记「不操作公共远程分支」的原则，就能放心用它优化日常开发流程。