Git合并工具在开发中的使用指南

在团队协作开发中，Git 是最常用的版本控制工具，而代码合并（Merge）是多人协作不可避免的环节。当多个开发者同时修改同一文件的相同区域时，Git 无法自动完成合并，此时需要借助合并工具（Merge Tool）手动解决冲突。本文将详细介绍 Git 合并工具的使用方法、常用命令及主流工具推荐。

一、Git 合并冲突的产生场景

当执行以下操作时可能触发合并冲突：

• git merge（合并分支）

• git pull（拉取远程代码）

• git rebase（变基操作）

• git cherry-pick（选择性提交）

此时 Git 会提示 CONFLICT 并终止操作，需手动解决冲突。

二、Git 合并工具的核心命令

1. 查看冲突文件

git status

冲突文件会被标记为 Unmerged paths。

2. 启动合并工具

git mergetool

此命令会依次打开所有冲突文件对应的合并工具界面。

3. 配置合并工具（以 KDiff3 为例）

git config --global merge.tool kdiff3         # 设置默认工具
git config --global mergetool.kdiff3.path "/usr/bin/kdiff3"  # 指定工具路径

4. 标记冲突已解决

git add <file>  # 将解决后的文件标记为已解决
git commit      # 提交合并结果

三、主流合并工具及配置

1. Git 内置工具：diff3

• 特点：命令行工具，直接展示冲突标记。

• 冲突标记格式：

  <<<<<<< HEAD
  本地修改
  ||||||| merged common ancestors
  原始内容
  =======
  远程修改
  >>>>>>> branch-name

• 使用场景：适合简单冲突的快速修复。

2. KDiff3（跨平台）

• 安装：

  • Linux: sudo apt install kdiff3

  • macOS: brew install kdiff3

  • Windows: 官网下载安装包

• 配置：

  git config --global merge.tool kdiff3
  git config --global mergetool.kdiff3.trustExitCode true

• 优点：三窗格对比（本地/远程/基准），可视化操作。

3. Beyond Compare（商业软件）

• 配置：

  git config --global merge.tool bc3
  git config --global mergetool.bc3.path "/Applications/Beyond Compare.app/Contents/MacOS/bcomp"

• 优点：强大的文件对比与合并功能，支持文件夹同步。

4. Visual Studio Code（内置合并工具）

• 使用方法：

  1. 打开 VS Code，冲突文件会显示 Current Changes 和 Incoming Changes。

  2. 通过按钮选择保留本地或远程修改，或手动编辑。

• 优点：无需额外配置，适合日常开发环境。

四、合并工具工作流程示例

场景：合并 feature 分支到 main

git checkout main
git merge feature

出现冲突时：

1. 启动合并工具：

   git mergetool

2. 在工具中操作：

   • 查看三窗格对比（本地、远程、共同祖先）。

   • 点击按钮或拖动代码块选择保留的内容。

3. 保存并退出：

   • 工具退出后，Git 会自动生成合并后的文件。

4. 完成合并：

   git add resolved-file.txt
   git commit -m "Merge feature into main with conflict resolution"

五、高级技巧与注意事项

1. 仅对比不自动合并

git mergetool --no-prompt  # 手动决定每一步操作

2. 信任合并工具退出码

git config --global mergetool.trustExitCode true  # 工具退出后自动标记为已解决

3. 忽略空白字符差异

git merge -Xignore-all-space # 合并时忽略空格差异

4. 常见问题解决

• 工具未生效：检查路径配置是否正确，或通过 git config --list 验证配置。

• 残留 .orig 文件：添加 git config --global mergetool.keepBackup false 禁止生成备份。

六、总结

选择合适的合并工具能显著提升解决冲突的效率：

• 简单冲突：使用 VS Code 或内置 diff3。

• 复杂场景：推荐 KDiff3 或 Beyond Compare。

• 命令行爱好者：可尝试 vimdiff 或 emerge。

通过 git mergetool 结合可视化工具，开发者可以更直观地理清代码逻辑差异，降低协作成本。掌握这些工具的使用，是团队高效协作的重要保障！