uTools-Manuals/docs/git/git rerere.html
2019-04-08 23:22:26 +08:00

27 lines
11 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="c-markdown doc-markdown"><div class="doc-postil"><div class="c-markdown"><h2>名称</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>git-rerere  - 重复使用冲突合并的记录分辨率</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>概要</h2></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git rerere [clear|forget &lt;pathspec&gt;|diff|remaining|status|gc]</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>在采用相对较长时间的主题分支的工作流中开发人员有时需要一遍又一遍地解决相同的冲突直到主题分支完成合并到“release”分支或发送并接受上游</p></div></div><div class="doc-postil"><div class="c-markdown"><p>此命令通过在初始手动合并时记录冲突的自动合并结果和相应的手动分析结果,并将先前记录的手动分辨率应用于其相应的自动合并结果,来帮助开发人员处理此过程。</p></div></div><div class="doc-postil"><div class="c-markdown"><div class="table-wrapper"><table><thead><tr class="firstRow"><th style="text-align: left;"><div class="table-header"><p>注意</p></div></th><th style="text-align: left;"><div class="table-header"><p>您需要设置配置变量rerere.enabled才能启用此命令。</p></div></th></tr></thead><tbody></tbody></table></div></div></div><div class="doc-postil"><div class="c-markdown"><h2>命令</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>通常,<code>git rerere</code>运行时没有参数或用户干预。但是,它有几个允许它与其工作状态交互的命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">clear</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果要中止合并分辨率请重置rerere使用的元数据。调用<code>git am [--skip|--abort]</code><code>git rebase [--skip|--abort]</code>将自动调用此命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">forget</em> &lt;pathspec&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>&lt;pathspec&gt;中重置针对当前冲突记录的冲突解决方案。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">diff</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>显示分辨率当前状态的差异。跟踪用户解决冲突时更改的内容很有用。其他参数直接传递给<code>diff</code>安装在PATH中的系统命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">status</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>具有合并分辨率将会记录的冲突的打印路径。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">remaining</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>打印具有尚未由rerere自动解决的冲突的路径。这包括其分辨率无法通过rerere进行跟踪的路径例如冲突的子模块。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><em style="font-style: italic;">gc</em></p></div></div><div class="doc-postil"><div class="c-markdown"><p>Prune记录很久以前发生的冲突合并。默认情况下将修剪超过15天的未解决的冲突并修复60天以上的已解决冲突。这些默认值分别通过<code>gc.rerereUnresolved</code><code>gc.rerereResolved</code>配置变量进行控制。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>讨论</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>当您的主题分支修改主分支(或上游)在主题分支从其分支后触及的重叠区域时,即使在主题分支已准备好向上游推送之前,也可能需要使用最新的主分支进行测试:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">              o---*---o topic             /
    o---o---o---*---o---o master</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>对于这样的测试,您需要以某种方式合并主题和主题。一种方法是将主人拉入主题分支:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">        $ git checkout topic
        $ git merge master
              o---*---o---+ topic             /           /
    o---o---o---*---o---o master</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>标记的提交<code>*</code>触摸同一文件中的同一区域; 您需要在创建标记为的提交时解决冲突<code>+</code>。然后您可以测试结果以确保您的工作进行中仍然适用于最新的master。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在这次测试合并之后,有两种方法可以继续您关于该主题的工作。最简单的方法是在测试合并提交的基础上构建<code>+</code>,当主题分支中的工作终于准备就绪后,将主题分支拉入主内容中,和/或请求上游从您那里撤出。然而到那时,主测试或上游测试合并后可能已经进阶<code>+</code>,在这种情况下,最终提交图如下所示:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">        $ git checkout topic
        $ git merge master
        $ ... work on both topic and master branches
        $ git checkout master
        $ git merge topic
              o---*---o---+---o---o topic             /           /         \
    o---o---o---*---o---o---o---o---+ master</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>然而当你的主题分支是长期存在的时候你的主题分支最终会有很多这样的“Merge from master”提交这会不必要地混淆发展历史。Linux内核邮件列表的读者可能还记得当一个子系统维护者要求从一个充满“useless merges”的分支中拉出时Linus抱怨这种频繁的测试合并。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>作为替代方案,为了保持主题分支不受测试合并的干扰,您可以放弃测试合并,并在测试合并之前继续构建在提示之上:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">        $ git checkout topic
        $ git merge master
        $ git reset --hard HEAD^ ;# rewind the test merge
        $ ... work on both topic and master branches
        $ git checkout master
        $ git merge topic
              o---*---o-------o---o topic             /                     \
    o---o---o---*---o---o---o---o---+ master</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>当您的主题分支最终准备就绪并合并到主分支时,这将只剩下一个合并提交。此合并将要求您解决标记为的提交引入的冲突<code>*</code>。但是,这种冲突通常与您在创建测试合并时所解决的冲突相同。<code>git rerere</code>使用您早先解决的问题中的信息帮助您解决最终冲突的合并问题。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>运行<code>git rerere</code>一个冲突automerge后立即命令记录冲突工作树中的文件与通常的冲突标志<code>&lt;&lt;&lt;&lt;&lt;&lt;&lt;</code><code>=======</code>以及<code>&gt;&gt;&gt;&gt;&gt;&gt;&gt;</code>在其中。稍后,在解决冲突之后,<code>git rerere</code>再次运行将记录这些文件的已解决状态。假设您在创建主控测试合并到主题分支时执行了此操作。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>下一次在看到相同的冲突automerge之后运行<code>git rerere</code>将执行早先冲突的automerge早期的手动分辨率和当前冲突的automerge之间的三方合并。如果这个三路合并干净地解决结果写出到您的工作树文件因此您不必手动解决它。请注意<code>git rerere</code>单独保留索引文件,因此您仍然需要使用<code>git diff</code>(或<code>git diff -c</code>)进行最终的完整性检查,并且<code>git add</code>当您满意时。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>作为一种便利措施,<code>git merge</code>自动调用<code>git rerere</code>退出时失败的自动合并,<code>git rerere</code>并在新的冲突时记录手的解决方案,或者在不是时重新使用先前的手解决方案。在提交合并结果时<code>git commit</code>也会调用<code>git rerere</code>。这意味着你不需要做任何特别的事情除了启用rerere.enabled配置变量</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在我们的示例中,当您进行测试合并时,手动解析会被记录下来,并且只要记录的分辨率仍然适用,稍后使用更新的主控和主题分支进行实际合并时,它将被重用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>信息<code>git rerere</code>记录也在运行时使用<code>git rebase</code>。在主题分支上淘汰测试合并并继续开发之后:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">              o---*---o-------o---o topic             /
    o---o---o---*---o---o---o---o   master
        $ git rebase master topic
                                  o---*---o-------o---o topic                                 /
    o---o---o---*---o---o---o---o   master</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>您可以运行<code>git rebase master topic</code>,在您的主题准备好向上游发送之前让自己保持最新状态。这会导致回退到三路合并,并且与您之前解决的测试合并相同。<code>git rerere</code>将通过运行<code>git rebase</code>来帮助你解决这个冲突。</p></div></div></div>