Git高级技巧：rebase、cherry-pick、submodule

大多数开发者对 Git 的 add、commit、push、pull 已经驾轻就熟，但当面对复杂的分支管理、历史整理和跨仓库协作时，往往会感到力不从心。本文将深入讲解 Git 的三个高级利器——rebase、cherry-pick 和 submodule，以及冲突解决技巧，帮助你把版本控制玩得出神入化。

一、Git Rebase 变基

rebase 是 Git 中最强大也最容易让人困惑的命令之一。它的核心作用是"重写历史"，把一系列提交从一个分支转移到另一个分支上，使提交历史保持线性整洁。

1.1 merge 与 rebase 的区别

假设当前分支 feature 是从 main 拉出来的，期间 main 又有了新提交：

• merge：会创建一个新的合并提交，保留两条分支的完整历史，但历史会形成"菱形"结构。
• rebase：把 feature 的提交"摘下来"，接到 main 最新提交之后，形成一条直线，历史更干净。

bash# 当前在 feature 分支，将 main 的更新合并进来

# 方式一：merge（保留分支历史）
git checkout feature
git merge main

# 方式二：rebase（线性历史）
git checkout feature
git rebase main
# rebase 后 feature 的提交会"接"到 main 最新提交之后
# 如果 feature 已推送到远程，需要强制推送
git push --force-with-lease origin feature

黄金法则：永远不要对已经推送到公共仓库的分支执行 rebase！因为 rebase 会重写提交历史，会导致其他协作者的仓库混乱。rebase 只用于整理本地未共享的提交。

1.2 交互式 rebase

交互式 rebase 是整理提交历史的神器，可以合并、修改、删除、调整提交顺序。这是提升 commit 质量的核心手段。

bash# 整理最近 5 个提交
git rebase -i HEAD~5

执行后会打开编辑器，显示如下内容：

text# 前面的 pick 表示保留该提交
pick   a1b2c3d 添加用户登录功能
pick   e4f5g6h 修复登录 bug
pick   7i8j9k0 添加登录日志
pick   l1m2n3o 更新文档
pick   p4q5r6s 优化代码格式

# 可用的命令：
# pick   (p) - 保留提交
# reword (r) - 保留提交但修改提交信息
# squash (s) - 合并到上一个提交
# fixup  (f) - 合并到上一个提交，丢弃提交信息
# drop   (d) - 删除该提交
# edit   (e) - 暂停以修改该提交

例如，把后两个小提交合并到第一个里：

textpick   a1b2c3d 添加用户登录功能
fixup  e4f5g6h 修复登录 bug
fixup  7i8j9k0 添加登录日志
pick   l1m2n3o 更新文档
drop   p4q5r6s 优化代码格式

保存退出后，Git 会自动整理这 5 个提交，最终变成 2 个干净的提交。这样在合并到主分支时，历史会非常整洁。

1.3 rebase 冲突解决

rebase 过程中可能遇到冲突，解决方式与 merge 类似，但流程略有不同：

bash# rebase 时遇到冲突
git rebase main

# 1. 查看冲突文件
git status

# 2. 手动编辑冲突文件，解决 <<<<<<< ======= >>>>>>> 标记

# 3. 标记冲突已解决
git add <冲突文件>

# 4. 继续 rebase（不要用 git commit！）
git rebase --continue

# 如果想放弃本次 rebase
git rebase --abort

# 跳过当前冲突的提交
git rebase --skip

二、Git Cherry-pick 选择性合并

cherry-pick 允许你把某个分支上的单个或多个提交应用到当前分支，而不合并整个分支。这在需要把某个 bug 修复同步到多个分支时特别有用。

2.1 基本用法

bash# 场景：在 develop 分支修复了一个 bug，需要同步到 main

# 1. 先查看 develop 分支的提交记录，找到目标提交的 hash
git log develop --oneline
# 输出示例：
# a1b2c3d (develop) 修复支付金额计算错误
# e4f5g6h 添加支付页面

# 2. 切换到 main 分支
git checkout main

# 3. 把指定的提交应用到当前分支
git cherry-pick a1b2c3d

# cherry-pick 多个提交
git cherry-pick a1b2c3d e4f5g6h

# cherry-pick 一个范围（不含起始，含结束）
git cherry-pick A..B

# cherry-pick 一个范围（含起始和结束）
git cherry-pick A^..B

2.2 cherry-pick 冲突解决

bashgit cherry-pick a1b2c3d
# 如果遇到冲突：

# 1. 解决冲突文件
# 2. 添加到暂存区
git add <文件>

# 3. 继续 cherry-pick
git cherry-pick --continue

# 放弃
git cherry-pick --abort

2.3 实用场景

• 热修复同步：在生产分支修复紧急 bug 后，cherry-pick 到开发分支
• 选择性移植：从实验分支挑选有用的提交到主分支
• 撤销错误合并：误把提交放错分支时，可以 cherry-pick 到正确分支再删除

注意：cherry-pick 会产生新的提交（hash 不同），虽然内容相同。如果两个分支都包含相同改动，后续合并可能产生冲突，需留意重复应用的问题。

三、Git Submodule 子模块

当一个项目需要引用另一个独立的 Git 仓库时（比如公共组件库、配置仓库），submodule 是官方提供的解决方案。它允许你在一个仓库中嵌套另一个仓库，且各自保持独立版本控制。

3.1 添加子模块

bash# 在主仓库中添加子模块
# 语法：git submodule add <仓库地址> <本地路径>
git submodule add https://github.com/example/common-lib.git libs/common

# 添加后会生成 .gitmodules 文件，记录子模块信息
# 同时 libs/common 目录会被纳入版本控制

# 提交主仓库的变更
git add .gitmodules libs/common
git commit -m "添加 common-lib 子模块"
git push

3.2 克隆含子模块的项目

bash# 方式一：克隆时同时初始化子模块
git clone --recurse-submodules https://github.com/example/main-project.git

# 方式二：先克隆，再初始化子模块
git clone https://github.com/example/main-project.git
cd main-project
git submodule init
git submodule update

# 方式三：一步到位（推荐）
git submodule update --init --recursive

3.3 更新子模块

bash# 进入子模块目录
cd libs/common

# 像普通仓库一样拉取最新代码
git checkout main
git pull origin main

# 回到主仓库，子模块指针已变化，需要提交
cd ../..
git add libs/common
git commit -m "更新 common-lib 到最新版本"

# 批量更新所有子模块到各自远程最新
git submodule update --remote --merge

3.4 删除子模块

删除子模块的步骤稍微繁琐，需要多处清理：

bash# 1. 取消暂存
git submodule deinit -f libs/common

# 2. 删除 gitlink
git rm -f libs/common

# 3. 删除 .git/modules 中的记录
rm -rf .git/modules/libs/common

# 4. 提交
git commit -m "移除 common-lib 子模块"

四、其他实用高级技巧

4.1 撤销操作

bash# 撤销工作区的修改（未 add）
git checkout -- <文件>
git restore <文件>          # Git 2.23+ 新语法

# 撤销暂存（已 add，未 commit）
git reset HEAD <文件>
git restore --staged <文件>  # Git 2.23+ 新语法

# 撤销最近一次提交（保留改动在工作区）
git reset --soft HEAD~1

# 撤销最近一次提交（保留改动在暂存区）
git reset --mixed HEAD~1

# 撤销最近一次提交（彻底丢弃改动，危险！）
git reset --hard HEAD~1

# 安全的撤销：生成一个反向提交（推荐用于公共分支）
git revert <commit-hash>

4.2 stash 暂存

当工作做到一半需要切换分支，又不想提交半成品时，stash 可以临时保存工作区状态。

bash# 保存当前工作区
git stash
git stash push -m "登录功能开发中"  # 带说明

# 查看暂存列表
git stash list

# 恢复最近一次暂存（并删除该暂存）
git stash pop

# 恢复指定暂存（保留暂存记录）
git stash apply stash@{0}

# 删除暂存
git stash drop stash@{0}

# 清空所有暂存
git stash clear

4.3 reflog 找回丢失的提交

即使误删了分支或 reset 了提交，Git 的 reflog 依然记录着所有操作，可以帮你找回"丢失"的代码。

bash# 查看所有操作记录
git reflog
# 输出示例：
# a1b2c3d HEAD@{0}: reset: moving to HEAD~1
# e4f5g6h HEAD@{1}: commit: 重要的提交

# 找到误删提交的 hash，恢复它
git reset --hard e4f5g6h

4.4 bisect 二分查找 bug

当引入了一个难以定位的 bug 时，bisect 可以用二分法快速定位是哪个提交引入的问题。

bash# 启动二分查找
git bisect start

# 标记当前（有 bug）的提交为 bad
git bisect bad

# 标记一个已知正常的提交为 good
git bisect good v1.0.0

# Git 会自动切到中间的提交，你测试后告诉 Git 结果
git bisect good   # 这个提交正常
# 或
git bisect bad    # 这个提交有问题

# 重复直到定位到引入 bug 的提交，然后结束
git bisect reset

五、团队协作工作流建议

总结

本文深入讲解了 Git 的三个高级核心功能：rebase 用于整理提交历史、cherry-pick 用于选择性移植提交、submodule 用于管理嵌套仓库，并补充了撤销、暂存、reflog、bisect 等实用技巧。这些命令在复杂项目协作中能极大提升效率。

掌握 Git 高级技巧的关键在于理解每个命令对提交历史的实际影响，并在实践中建立自己的判断标准。记住 rebase 的黄金法则——只对本地未共享的提交变基；善用交互式 rebase 保持提交整洁；遇到误操作别慌，reflog 是你的后悔药。把这些技巧融入日常工作流，你的版本控制能力将会有质的飞跃。