ProGit2 项目解析：Git Rerere 功能详解

ProGit2 项目解析：Git Rerere 功能详解

progit2 Pro Git 2nd Edition 项目地址: https://gitcode.com/gh_mirrors/pr/progit2

什么是 Git Rerere

Git Rerere（Reuse Recorded Resolution）是 Git 中一个强大但鲜为人知的功能，它能够记住你解决过的合并冲突，并在下次遇到相同冲突时自动应用之前的解决方案。这个功能对于长期维护分支或频繁进行合并/变基操作的开发者来说特别有用。

Rerere 的应用场景

1. 长期分支维护：当你在维护一个长期存在的特性分支时，可以定期尝试合并到主分支，解决冲突后回退合并。Rerere 会记住你的解决方案，最终合并时自动处理这些冲突。

2. 频繁变基操作：如果你经常需要变基分支，Rerere 可以避免你反复解决相同的冲突。

3. 测试性合并：在将多个特性分支合并到测试分支时，如果测试失败，可以回退合并而不必重新解决冲突。

启用 Rerere 功能

要启用 Rerere 功能，只需执行以下命令：

git config --global rerere.enabled true

这个设置会全局启用 Rerere 功能。你也可以通过创建 .git/rr-cache 目录来为特定仓库启用该功能。

实战示例

让我们通过一个 Ruby 文件 hello.rb 的示例来演示 Rerere 的工作流程：

原始文件内容：

#! /usr/bin/env ruby

def hello
  puts 'hello world'
end

场景设置

1. 在分支 A 中，将 "hello" 改为 "hola"
2. 在分支 B 中，将 "world" 改为 "mundo"

合并冲突

当合并这两个分支时，会产生冲突：

$ git merge i18n-world
Auto-merging hello.rb
CONFLICT (content): Merge conflict in hello.rb
Recorded preimage for 'hello.rb'
Automatic merge failed; fix conflicts and then commit the result.

注意输出中的 Recorded preimage for 'hello.rb'，这表明 Rerere 已经记录了冲突前的状态。

查看冲突状态

使用 git rerere status 查看 Rerere 记录的状态：

$ git rerere status
hello.rb

使用 git rerere diff 查看当前解决方案：

$ git rerere diff
--- a/hello.rb
+++ b/hello.rb
@@ -1,11 +1,11 @@
 #! /usr/bin/env ruby

 def hello
-<<<<<<<
-  puts 'hello mundo'
-=======
+<<<<<<< HEAD
   puts 'hola world'
->>>>>>>
+=======
+  puts 'hello mundo'
+>>>>>>> i18n-world
 end

解决冲突

手动解决冲突为 puts 'hola mundo' 后，Rerere 会记录这个解决方案：

$ git rerere diff
--- a/hello.rb
+++ b/hello.rb
@@ -1,11 +1,7 @@
 #! /usr/bin/env ruby

 def hello
-<<<<<<<
-  puts 'hello mundo'
-=======
-  puts 'hola world'
->>>>>>>
+  puts 'hola mundo'
 end

提交解决方案后，Rerere 会记录这个解决方案：

$ git add hello.rb
$ git commit
Recorded resolution for 'hello.rb'.

测试 Rerere 功能

现在撤销合并并尝试变基：

$ git reset --hard HEAD^
$ git checkout i18n-world
$ git rebase master

在变基过程中遇到相同冲突时，Git 会自动应用之前记录的解决方案：

Resolved 'hello.rb' using previous resolution.

查看文件，会发现冲突已经自动解决：

#! /usr/bin/env ruby

def hello
  puts 'hola mundo'
end

高级用法

1. 查看自动解决方案：使用 git diff 可以查看自动应用的解决方案：

$ git diff
diff --cc hello.rb
index a440db6,54336ba..0000000
--- a/hello.rb
+++ b/hello.rb
@@@ -1,7 -1,7 +1,7 @@@
  #! /usr/bin/env ruby

  def hello
-   puts 'hola world'
 -  puts 'hello mundo'
++  puts 'hola mundo'
  end

2. 重现冲突状态：如果需要重新查看冲突状态，可以使用：

$ git checkout --conflict=merge hello.rb

3. 手动触发 Rerere：可以使用 git rerere 命令手动触发冲突解决：

$ git rerere
Resolved 'hello.rb' using previous resolution.

总结

Git Rerere 是一个强大的工具，特别适合以下情况：

• 维护长期分支
• 频繁进行变基操作
• 需要测试性合并的场景

通过记录和重用冲突解决方案，Rerere 可以显著减少重复劳动，让版本控制工作更加高效。对于复杂的项目开发流程，启用 Rerere 功能可以为你节省大量时间。

progit2 Pro Git 2nd Edition 项目地址: https://gitcode.com/gh_mirrors/pr/progit2