在團隊協作開發中，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?結合可視化工具，開發者可以更直觀地理清代碼邏輯差異，降低協作成本。掌握這些工具的使用，是團隊高效協作的重要保障！