mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-08 23:14:06 +08:00
3 lines
12 KiB
HTML
3 lines
12 KiB
HTML
<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-cherry-pick - 应用一些现有提交引入的更改</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>概要</h2></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">git cherry-pick [--edit] [-n] [-m parent-number] [-s] [-x] [--ff] [-S[<keyid>]] <commit>…
|
||
|
||
git cherry-pick --continuegit cherry-pick --quit
|
||
|
||
git cherry-pick --abort</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>给定一个或多个现有的提交，应用每个引入的更改，为每个提交一个新的提交。这要求你的工作树是干净的（不需要修改 HEAD 提交）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果不清楚如何应用更改，则会发生以下情况：</p></div></div><div class="doc-postil"><div class="c-markdown"><ol class="ol-level-0 list-paddingleft-2"><li><p>当前分支和<code>HEAD</code>指针停留在最后一次成功提交。</p></li><li><p>该<code>CHERRY_PICK_HEAD</code>Ref设定点在提交该介绍，很难应用更改。</p></li><li><p>干净地应用更改的路径在索引文件和工作树中都会更新。</p></li><li><p>对于冲突的路径，索引文件最多可以记录三个版本，如 git-merge [1] 的 “TRUE MERGE” 部分所述。工作树中的文件将包括通常的冲突标记括号冲突的描述<code><<<<<<<</code>和<code>>>>>>>></code>。</p></li><li><p>没有其他修改。</p></li></ol></div></div><div class="doc-postil"><div class="c-markdown"><p>有关解决此类冲突的一些提示，请参阅 git-merge [1]。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p><commit>…</p></div></div><div class="doc-postil"><div class="c-markdown"><p>递交 cherry-pick 。有关拼写提交的更完整列表，请参阅 gitrevisions [7]。可以传递提交集，但默认情况下不进行遍历，就像<code>--no-walk</code>指定了选项一样，请参阅 git-rev-list [1] 。请注意，指定一个范围会将所有 <commit> ...参数提供给单个修订步骤（请参阅稍后使用的示例<code>maint master..next</code>）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-e --edit</p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用此选项，<code>git cherry-pick</code>可让您在提交之前编辑提交消息。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-x</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当记录提交时，在原始提交消息中附加一行说“（从挑选中提取的樱桃...）”，以表明该更改是从哪个提交中挑选出来的。这只对樱桃选择没有冲突。如果您正在从您的私人分支进行挑选，请勿使用此选项，因为这些信息对收件人无用。另一方面，如果您在两个公开可见的分支之间进行选择（例如，向开发分支中的旧版本的维护分支返回修复），添加此信息可能很有用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-r</p></div></div><div class="doc-postil"><div class="c-markdown"><p>它曾经是命令默认做<code>-x</code>了上面描述，并且<code>-r</code>是禁用它。现在默认不这样做<code>-x</code>，这个选项是没有操作的。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-m parent-number --mainline parent-number</p></div></div><div class="doc-postil"><div class="c-markdown"><p>通常你不能选择合并，因为你不知道合并的哪一边应该被认为是主线。此选项指定主线路的父代号码（从1开始），并允许 cherry-pick 重播相对于指定的父代的更改。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-n --no-commit</p></div></div><div class="doc-postil"><div class="c-markdown"><p>通常，该命令会自动创建一系列提交。此标志应用所需的更改，以便将每个命名提交挑选到工作树和索引，而不进行任何提交。此外，使用此选项时，您的索引不必与 HEAD 提交匹配。cherry-pick 是根据索引的开始状态完成的。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当在一行中选择多个“索引”效果到索引时，这非常有用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-s --signoff</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在提交消息的末尾添加 Signed-off-by 行。有关更多信息，请参阅 git-commit [1] 中的 signoff 选项。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-S<keyid> --gpg-sign=<keyid></p></div></div><div class="doc-postil"><div class="c-markdown"><p>GPG 标志提交。该<code>keyid</code>参数是可选的，并且默认为提交者身份; 如果指定，它必须粘贴到选项没有空格。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--ff</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果当前的 HEAD 与 cherry-pick 的提交的父对象相同，则将执行快速转发此提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--allow-empty</p></div></div><div class="doc-postil"><div class="c-markdown"><p>默认情况下，cherry-pick 一个空的提交将失败，表明需要显式调用<code>git commit --allow-empty</code>。该选项会覆盖该行为，允许空提交在 cherry-pick 中自动保留。请注意，当“--ff”有效时，即使没有此选项，也会保留符合“快进”要求的空提交。还要注意，使用这个选项只保留最初为空的提交（即提交记录与其父代相同的树）。由于先前的提交而提交的提交被删除。强制包含这些提交使用<code>--keep-redundant-commits</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--allow-empty-message</p></div></div><div class="doc-postil"><div class="c-markdown"><p>默认情况下，用空信息挑选提交将失败。该选项将覆盖该行为，允许提交空消息提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--keep-redundant-commits</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果提交 cherry-pick 复制了当前历史记录中的提交，它将变为空。默认情况下，这些冗余提交会导致<code>cherry-pick</code>停止，以便用户可以检查提交。该选项将覆盖该行为并创建一个空的提交对象。意味着<code>--allow-empty</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--strategy=<strategy></p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用给定的合并策略。只能使用一次。有关详细信息，请参阅 git-merge [1] 中的 MERGE STRATEGIES 部分。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-X<option> --strategy-option=<option></p></div></div><div class="doc-postil"><div class="c-markdown"><p>将合并策略特定选项传递给合并策略。有关详细信息，请参阅 git-merge [1] 。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>Sequencer 子命令</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>--continue</p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用中的信息继续正在进行的操作<code>.git/sequencer</code>。可以在解决失败的 cherry-pick 或恢复中的冲突后继续使用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--quit</p></div></div><div class="doc-postil"><div class="c-markdown"><p>忘记当前正在进行的操作。在 cherry-pick 或恢复失败后可用于清除定序器状态。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--abort</p></div></div><div class="doc-postil"><div class="c-markdown"><p>取消操作并返回到预序列状态。</p></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 cherry-pick master</code></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 cherry-pick ..master</code> <code>git cherry-pick ^HEAD master</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>应用所有提交的引用变更，这些提交是 master 的祖先，但不是 HEAD 的祖先，以产生新的提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git cherry-pick maint next ^master</code> <code>git cherry-pick maint master..next</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>应用所有提交的所有提交的变更，这些提交是 maint 或 next 的祖先，但不是 master 或其祖先。需要注意的是，后者并不意味着<code>maint</code>之间的一切，<code>master</code>和<code>next</code>; 具体而言，<code>maint</code>如果包含在内，则不会被使用<code>master</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git cherry-pick master~4 master~2</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>应用由 master 指向的第五次和第三次提交所引入的更改，并创建两个新提交并进行这些更改。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git cherry-pick -n master~1 next</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>向工作树和索引应用由 master 指向的第二次提交引入的更改以及 next 指向的最后一个提交的更改，但不要使用这些更改创建任何提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git cherry-pick --ff ..next</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果历史记录是线性的并且 HEAD 是下一个祖先，则更新工作树并前进 HEAD 指针以匹配下一个。否则，将那些位于 next 而不是 HEAD 的提交引入的更改应用于当前分支，为每个新更改创建一个新的提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git rev-list --reverse master -- README | git cherry-pick -n --stdin</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>将触及 README 的主分支上的所有提交引入的更改应用于工作树和索引，以便可以检查结果并在合适的情况下将其作为单个新提交。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>以下顺序尝试回溯修补程序，因为修补程序适用的代码发生了太多变化，然后再次尝试，因此这段时间会更注意匹配上下文行。</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">$ git cherry-pick topic^ (1)$ git diff (2)$ git reset --merge ORIG_HEAD (3)$ git cherry-pick -Xpatience topic^ (4)</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><ol class="ol-level-0 list-paddingleft-2"><li><p>应用将显示的更改<code>git show topic^</code>。在这个例子中，这个补丁并没有很好的应用，所以关于冲突的信息被写入索引和工作树，并且没有新的提交结果。</p></li><li><p>总结要调和的变化</p></li><li><p>取消 cherry-pick 。换句话说，返回到 cherry-pick 前的状态，保留您在工作树中进行的任何本地修改。</p></li><li><p>尝试应用<code>topic^</code>再次引入的更改，花费额外的时间避免基于错误匹配的上下文行的错误。</p></li></ol></div></div></div> |