• 首页
  • vue
  • TypeScript
  • JavaScript
  • scss
  • css3
  • html5
  • php
  • MySQL
  • redis
  • jQuery
  • Rerere

    git rerere功能是一个隐藏的功能。正如它的名字“重用记录的解决方案(reuse recorded resolution)”所示,它允许你让 Git 记住解决一个块冲突的方法,这样在下一次看到相同冲突时,Git 可以为你自动地解决它。

    有几种情形下这个功能会非常有用。在文档中提到的一个例子是想要保证一个长期分支会干净地合并,但是又不想要一串中间的合并提交弄乱你的提交历史。将rerere功能开启后,你可以试着偶尔合并,解决冲突,然后退出合并。如果你持续这样做,那么最终的合并会很容易,因为rerere可以为你自动做所有的事情。

    可以将同样的策略用在维持一个变基的分支时,这样就不用每次解决同样的变基冲突了。或者你将一个分支合并并修复了一堆冲突后想要用变基来替代合并——你可能并不想要再次解决相同的冲突。

    另一个rerere的应用场景是当你偶尔将一堆正在改进的主题分支合并到一个可测试的头时,就像 Git 项目自身经常做的。如果测试失败,你可以倒回合并之前然后在去除导致测试失败的那个主题分支后重做合并,而不用再次重新解决所有的冲突。

    要启用rerere功能,只需运行以下配置选项即可:

    $ git config --global rerere.enabled true
    

    你也可以通过在特定的仓库中创建.git/rr-cache目录来开启它,但是设置选项更干净并且可以应用到全局。

    现在我们看一个简单的例子,类似之前的那个。假设有一个名为hello.rb的文件如下:

    #! /usr/bin/env ruby
    
    def hello
      puts 'hello world'
    end
    

    在一个分支中修改单词“hello”为“hola”,然后在另一个分支中修改“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 FILE。除此之外它应该看起来就像一个普通的合并冲突。在这个时候,rerere可以告诉我们几件事。和往常一样,在这个时候你可以运行git status来查看所有冲突的内容:

    $ git status
    # On branch master
    # Unmerged paths:
    #   (use "git reset HEAD <file>..." to unstage)
    #   (use "git add <file>..." to mark resolution)
    #
    #	both modified:      hello.rb
    #
    

    然而,git rerere也会通过git rerere status告诉你它记录的合并前状态。

    $ 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
    

    同样(这并不是真的与rerere有关系),可以使用git ls-files -u来查看冲突文件的之前、左边与右边版本:

    $ git ls-files -u
    100644 39804c942a9c1f2c03dc7c5ebcd7f3e3a6b97519 1	hello.rb
    100644 a440db6e8d1fd76ad438a49025a9ad9ce746f581 2	hello.rb
    100644 54336ba847c3758ab604876419607e9443848474 3	hello.rb
    

    现在可以通过改为puts 'hola mundo'来解决它,可以再次运行git rerere diff命令来查看 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
    

    所以从本质上说,当 Git 看到一个hello.rb文件的一个块冲突中有“hello mundo”在一边与“hola world”在另一边,它会将其解决为“hola mundo”。

    现在我们可以将它标记为已解决并提交它:

    $ git add hello.rb
    $ git commit
    Recorded resolution for 'hello.rb'.
    [master 68e16e5] Merge branch 'i18n'
    

    可以看到它"Recorded resolution for FILE"。

    现在,让我们撤消那个合并然后将它变基到master分支顶部来替代它。可以通过使用之前在重置揭密看到的git reset来回滚分支。

    $ git reset --hard HEAD^
    HEAD is now at ad63f15 i18n the hello
    

    我们的合并被撤消了。现在让我们变基主题分支。

    $ git checkout i18n-world
    Switched to branch 'i18n-world'
    
    $ git rebase master
    First, rewinding head to replay your work on top of it...
    Applying: i18n one word
    Using index info to reconstruct a base tree...
    Falling back to patching base and 3-way merge...
    Auto-merging hello.rb
    CONFLICT (content): Merge conflict in hello.rb
    Resolved 'hello.rb' using previous resolution.
    Failed to merge in the changes.
    Patch failed at 0001 i18n one word
    

    现在,正像我们期望的一样,得到了相同的合并冲突,但是看一下Resolved FILE using previous resolution这行。如果我们看这个文件,会发现它已经被解决了,而且在它里面没有合并冲突标记。

    #! /usr/bin/env ruby
    
    def hello
      puts 'hola mundo'
    end
    

    同样,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
    

    也可以通过git checkout命令重新恢复到冲突时候的文件状态:

    $ git checkout --conflict=merge hello.rb
    $ cat hello.rb
    #! /usr/bin/env ruby
    
    def hello
    <<<<<<< ours
      puts 'hola world'
    =======
      puts 'hello mundo'
    >>>>>>> theirs
    end
    

    我们将会在高级合并中看到这个的一个例子。然而现在,让我们通过运行git rerere来重新解决它:

    $ git rerere
    Resolved 'hello.rb' using previous resolution.
    $ cat hello.rb
    #! /usr/bin/env ruby
    
    def hello
      puts 'hola mundo'
    end
    

    我们通过rerere缓存的解决方案来自动重新解决了文件冲突。现在可以添加并继续变基来完成它。

    $ git add hello.rb
    $ git rebase --continue
    Applying: i18n one word
    

    所以,如果做了很多次重新合并,或者想要一个主题分支始终与你的master分支保持最新但却不想要一大堆合并,或者经常变基,打开rerere功能可以帮助你的生活变得更美好。

    上篇:高级合并

    下篇:使用 Git 调试