设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
-
2.52.0
2025-11-17
- 2.51.2 无变更
-
2.51.1
2025-10-15
- 2.50.1 → 2.51.0 无变更
-
2.50.0
2025-06-16
- 2.45.1 → 2.49.1 无更改
-
2.45.0
2024-04-29
- 2.43.1 → 2.44.4 无更改
-
2.43.0
2023-11-20
- 2.41.1 → 2.42.4 无更改
-
2.41.0
2023-06-01
- 2.38.3 → 2.40.4 无更改
-
2.38.2
2022-12-11
- 2.38.1 无更改
-
2.38.0
2022-10-02
- 2.37.1 → 2.37.7 无更改
-
2.37.0
2022-06-27
- 2.31.1 → 2.36.6 无更改
-
2.31.0
2021-03-15
- 2.22.1 → 2.30.9 无更改
-
2.22.0
2019-06-07
- 2.20.1 → 2.21.4 无更改
-
2.20.0
2018-12-09
- 2.12.5 → 2.19.6 无更改
-
2.11.4
2017-09-22
- 2.2.3 → 2.10.5 无更改
-
2.1.4
2014-12-17
-
2.0.5
2014-12-17
描述
使用 git mergetool 来运行多个合并工具中的一个来解决合并冲突。它通常在 git merge 之后运行。
如果给出了一个或多个 <file> 参数，则会运行合并工具程序来解决每个文件中的差异（跳过没有冲突的文件）。指定一个目录将包括该路径下的所有未解决的文件。如果未指定任何 <file> 名称，git mergetool 将在所有有合并冲突的文件上运行合并工具程序。
选项
-t<tool>--tool=<tool>-
使用 <tool> 指定的合并分辨率程序。有效值包括
emerge、gvimdiff、kdiff3、meld、vimdiff和tortoisemerge。运行gitmergetool--tool-help获取有效 <tool> 设置的列表。如果没有指定合并分辨率程序，
gitmergetool将使用配置变量merge.tool。如果未设置merge.tool配置变量，gitmergetool将选择一个合适的默认值。您可以通过设置配置变量
mergetool.<tool>.path来显式提供工具的完整路径。例如，您可以通过设置mergetool.kdiff3.path来配置 kdiff3 的绝对路径。否则，gitmergetool假定该工具在$PATH中可用。而不是运行一个已知的合并工具程序，
gitmergetool可以通过在配置变量mergetool.<tool>.cmd中指定要调用的命令行来定制以运行一个替代程序。当
gitmergetool使用此工具调用时（通过-t或--tool选项或merge.tool配置变量），配置的命令行将使用BASE设置为包含合并共同基础的临时文件的名称（如果可用）；LOCAL设置为包含当前分支文件内容的临时文件的名称；REMOTE设置为包含要合并文件的内容的临时文件的名称；MERGED设置为合并工具应将合并分辨率结果写入的文件名称。如果自定义合并工具通过其退出码正确指示了合并分辨率的成功，则配置变量
mergetool.<tool>.trustExitCode可以设置为true。否则，gitmergetool将提示用户在自定义工具退出后指示分辨率的成功。 --tool-help-
打印可以使用
--tool的合并工具列表。 -y--no-prompt-
在每次调用合并分辨率程序之前不进行提示。如果使用
--tool选项或merge.tool配置变量显式指定了合并分辨率程序，则这是默认行为。 --prompt-
在每次调用合并分辨率程序之前提示，以便用户有机会跳过该路径。
-g--gui-
当
git-mergetool使用-g或--gui选项调用时，将从配置的merge.guitool变量而不是merge.tool读取默认合并工具。如果未设置merge.guitool，我们将回退到merge.tool下配置的工具。这可以通过配置变量mergetool.guiDefault自动选择。 --no-gui-
这会覆盖先前的
-g或--gui设置或mergetool.guiDefault配置，并从配置的merge.tool变量读取默认合并工具。 -O<orderfile>-
按 <orderfile> 中指定的顺序处理文件，该文件每行有一个 shell glob 模式。这会覆盖
diff.orderFile配置变量（参见 git-config[1]）。要取消diff.orderFile，请使用-O/dev/null。
配置
本节中以下所有内容均从 git-config[1] 文档中选择性地包含。内容与彼处相同：
mergetool.<tool>.path-
覆盖给定工具的路径。当您的工具不在
$PATH中时，这很有用。 mergetool.<tool>.cmd-
指定调用指定合并工具的命令。指定的命令将在 shell 中进行评估，并可用以下变量：
BASE是要合并的文件的公共基础的临时文件名（如果可用）；LOCAL是当前分支文件内容的临时文件名；REMOTE是正在合并的分支的文件内容的临时文件名；MERGED包含合并工具应将成功合并结果写入的文件名。 mergetool.<tool>.hideResolved-
允许用户覆盖特定工具的全局
mergetool.hideResolved值。有关完整描述，请参阅mergetool.hideResolved。 mergetool.<tool>.trustExitCode-
对于自定义合并命令，指定是否可以使用合并命令的退出码来确定合并是否成功。如果未设置为 true，则会检查合并目标文件的修改时间戳，并且假定当文件已更新时合并成功；否则，将提示用户指示合并的成功。
mergetool.meld.hasOutput-
旧版本的
meld不支持--output选项。Git 将尝试通过检查meld--help的输出来检测meld是否支持--output。配置mergetool.meld.hasOutput将使 Git 跳过这些检查并使用配置的值。将mergetool.meld.hasOutput设置为true会告诉 Git 无条件使用--output选项，而false则会避免使用--output。 mergetool.meld.useAutoMerge-
当给出
--auto-merge时，meld 将自动合并所有非冲突部分，突出显示冲突部分，并等待用户决定。将mergetool.meld.useAutoMerge设置为true会告诉 Git 无条件地将--auto-merge选项与meld一起使用。将此值设置为auto会使 git 检测--auto-merge是否受支持，并且仅在可用时才使用--auto-merge。值为false则会完全避免使用--auto-merge，这也是默认值。 mergetool.<variant>.layout-
为 vimdiff 的 <variant> 配置分屏布局，<variant> 可以是
vimdiff、nvimdiff、gvimdiff中的任何一个。当使用--tool=<variant> (或者如果merge.tool配置为 <variant> 且没有--tool) 调用gitmergetool时，Git 将查阅mergetool.<variant>.layout来确定工具的布局。如果变体特定的配置不可用，将使用vimdiff的作为回退。如果这也不可用，将使用默认的 4 窗口布局。有关如何配置布局，请参阅 *特定后端提示* 部分。 mergetool.hideResolved-
在合并过程中，Git 将自动解决尽可能多的冲突，并将包含冲突标记的
$MERGED文件写入其中，并在任何它无法解决的冲突周围；$LOCAL和$REMOTE通常是 Git 冲突解决之前的文件的版本。此标志会导致$LOCAL和$REMOTE被覆盖，以便只有未解决的冲突呈现给合并工具。可以通过mergetool.<tool>.hideResolved配置变量为每个工具配置。默认为false。 mergetool.keepBackup-
执行合并后，原始的带有冲突标记的文件可以保存为扩展名为
.orig的文件。如果此变量设置为false，则此文件不会被保留。默认为true（即保留备份文件）。 mergetool.keepTemporaries-
调用自定义合并工具时，Git 使用一组临时文件传递给工具。如果工具返回错误并且此变量设置为
true，则将保留这些临时文件；否则，在工具退出后它们将被删除。默认为false。 mergetool.writeToTemp-
默认情况下，Git 在工作树中写入冲突文件的临时
BASE、LOCAL和REMOTE版本。当设置为true时，Git 将尝试为这些文件使用临时目录。默认为false。 mergetool.prompt-
在每次调用合并分辨率程序之前提示。
mergetool.guiDefault-
设置为
true以默认使用merge.guitool（相当于指定--gui参数），或设置为auto以根据DISPLAY环境变量的值是否存在来选择merge.guitool或merge.tool。默认值为false，此时必须显式提供--gui参数才能使用merge.guitool。
临时文件
git mergetool 在解决合并时会创建 *.orig 备份文件。一旦文件被合并并且其 git mergetool 会话完成，就可以安全地删除这些文件。
将 mergetool.keepBackup 配置变量设置为 false 会导致 git mergetool 在文件成功合并后自动删除备份文件。
特定后端提示
vimdiff
描述
当在 git mergetool 中指定 --tool=vimdiff 时，Git 将使用 4 窗口布局打开 Vim，布局如下：
------------------------------------------ | | | | | LOCAL | BASE | REMOTE | | | | | ------------------------------------------ | | | MERGED | | | ------------------------------------------
LOCAL、BASE 和 REMOTE 是只读缓冲区，显示冲突文件在特定提交中的内容（分别是“你正在合并到的提交”、“共同祖先提交”和“你正在合并的提交”）。
MERGED 是一个可写缓冲区，你必须在那里解决冲突（使用其他只读缓冲区作为参考）。一旦你完成，像往常一样保存并退出 Vim（:wq），或者如果你想中止，请使用 :cq 退出。
布局配置
你可以通过设置配置变量 mergetool.vimdiff.layout 来更改 Vim 使用的窗口布局，该变量接受一个字符串，其中以下分隔符具有特殊含义：
-
+用于“打开一个新标签页” -
,用于“打开一个新垂直分割” -
/用于“打开一个新水平分割” -
@用于指示包含解决冲突后最终版本的文件。如果不存在，默认为MERGED。
操作符的优先级如下（你可以使用括号来改变它）
`@` > `+` > `/` > `,`
让我们看一些例子来理解它是如何工作的：
-
layout="(LOCAL,BASE,REMOTE)/MERGED"这与我们已经看到的默认布局完全相同。
请注意，
/的优先级高于,，因此在这种情况下不需要括号。下一个布局定义是等效的：layout = "LOCAL,BASE,REMOTE / MERGED"
-
layout="LOCAL,MERGED,REMOTE"如果我们出于某种原因，对
BASE缓冲区不感兴趣：------------------------------------------ | | | | | | | | | LOCAL | MERGED | REMOTE | | | | | | | | | ------------------------------------------
-
layout="MERGED"只会显示
MERGED缓冲区。但请注意，所有其他缓冲区仍然加载在 vim 中，你可以使用“buffers”命令访问它们。------------------------------------------ | | | | | MERGED | | | | | ------------------------------------------
-
layout="@LOCAL,REMOTE"当布局中不存在
MERGED时，你必须用一个 `@` 符号标记一个缓冲区。这将成为你在解决冲突后需要编辑和保存的缓冲区。------------------------------------------ | | | | | | | | | | LOCAL | REMOTE | | | | | | | | | | ------------------------------------------
-
layout="LOCAL,BASE,REMOTE/MERGED+BASE,LOCAL+BASE,REMOTE"将打开三个标签页：第一个是默认布局的副本，而另外两个仅显示 (
BASE和LOCAL) 以及 (BASE和REMOTE) 之间的差异。------------------------------------------ | <TAB #1> | TAB #2 | TAB #3 | | ------------------------------------------ | | | | | LOCAL | BASE | REMOTE | | | | | ------------------------------------------ | | | MERGED | | | ------------------------------------------
------------------------------------------ | TAB #1 | <TAB #2> | TAB #3 | | ------------------------------------------ | | | | | | | | | | BASE | LOCAL | | | | | | | | | | ------------------------------------------
------------------------------------------ | TAB #1 | TAB #2 | <TAB #3> | | ------------------------------------------ | | | | | | | | | | BASE | REMOTE | | | | | | | | | | ------------------------------------------
-
layout="LOCAL,BASE,REMOTE/MERGED+BASE,LOCAL+BASE,REMOTE+(LOCAL/BASE/REMOTE),MERGED"与上一个示例相同，但添加了第四个标签页，其中包含与第一个标签页相同的信息，但布局不同。
--------------------------------------------- | TAB #1 | TAB #2 | TAB #3 | <TAB #4> | --------------------------------------------- | LOCAL | | |---------------------| | | BASE | MERGED | |---------------------| | | REMOTE | | ---------------------------------------------
请注意，在第三个标签页定义中，我们如何需要使用括号来使
,的优先级高于/。
变体
除了 --tool=vimdiff，你还可以使用以下其他变体：
-
--tool=gvimdiff，用于在 gVim 中打开而不是 Vim。 -
--tool=nvimdiff，用于在 Neovim 中打开而不是 Vim。
使用这些变体时，要指定自定义布局，你必须设置配置变量 mergetool.gvimdiff.layout 和 mergetool.nvimdiff.layout，而不是 mergetool.vimdiff.layout（尽管如果变体特定的布局不可用，后者将被用作回退）。
此外，为了向后兼容以前的 Git 版本，你还可以将 1、2 或 3 追加到 vimdiff 或任何变体（例如 vimdiff3、nvimdiff1 等）以使用预定义的布局。换句话说，使用 --tool=[g|n]vimdiff<x> 等同于使用 --tool=[g|n]vimdiff 并将配置变量 mergetool.[g|n]vimdiff.layout 设置为…
-
<x>
=1:"@LOCAL,REMOTE" -
<x>
=2:"LOCAL,MERGED,REMOTE" -
<x>
=3:"MERGED"
例如：使用 --tool=gvimdiff2 将以三个列（LOCAL、MERGED 和 REMOTE）打开 gvim。