如何用VSCode三方合并工具手动合并Git分支（无冲突场景）

一、先配置VSCode为Git合并工具 #

先让Git能调用VSCode处理合并，在终端执行以下全局配置命令：

git config --global merge.tool vscode
git config --global mergetool.vscode.cmd 'code --wait $MERGED'
git config --global mergetool.vscode.trustExitCode false

• trustExitCode false是因为VSCode的退出码不代表合并结果，Git会等你手动完成合并后再继续流程。

二、针对任意Git引用触发手动合并 #

核心思路是用git merge-file配合mergetool，直接指定三个版本的文件（共同祖先、左侧目标引用、右侧目标引用）：

1. 获取共同祖先引用：
   比如要对比main分支和某提交哈希a1b2c3，先获取它们的共同祖先：

   BASE_HASH=$(git merge-base main a1b2c3)
   

2. 导出三个版本的目标文件：
   假设要合并的文件是src/utils.js，导出到临时文件：

   git show $BASE_HASH:src/utils.js > base.txt
   git show main:src/utils.js > local.txt  # 左侧显示的版本
   git show a1b2c3:src/utils.js > remote.txt  # 右侧显示的版本
   

3. 调用VSCode三方合并：
   用Git的mergetool打开VSCode的合并界面：

   git mergetool --tool=vscode --base base.txt --local local.txt --remote remote.txt --output final.txt
   

   打开后VSCode的布局完全符合需求：左侧是local.txt（你指定的引用版本），右侧是remote.txt，底部是合并输出区，手动调整后保存final.txt即可。

4. 应用合并结果：
   把合并好的文件替换到工作区：

   cp final.txt src/utils.js
   

   之后就可以正常提交这个手动合并的结果。

三、简化操作：写个Shell脚本（可选） #

如果经常需要这个操作，写个脚本省去重复敲命令的麻烦，比如创建git-manual-merge.sh：

#!/bin/bash
# 用法：./git-manual-merge.sh <左侧引用> <右侧引用> <文件路径>
LEFT_REF=$1
RIGHT_REF=$2
FILE_PATH=$3

# 获取共同祖先
BASE_REF=$(git merge-base $LEFT_REF $RIGHT_REF)

# 导出临时文件
git show $BASE_REF:$FILE_PATH > .tmp.base
git show $LEFT_REF:$FILE_PATH > .tmp.local
git show $RIGHT_REF:$FILE_PATH > .tmp.remote

# 触发VSCode合并
git mergetool --tool=vscode --base .tmp.base --local .tmp.local --remote .tmp.remote --output .tmp.final

# 替换工作区文件
cp .tmp.final $FILE_PATH

# 清理临时文件
rm .tmp.base .tmp.local .tmp.remote .tmp.final

给脚本加执行权限：

chmod +x git-manual-merge.sh

使用时直接：

./git-manual-merge.sh main feature-branch src/utils.js

方案优势 #

• 无需强制制造冲突，完全按需触发手动合并
• 支持任意Git引用：分支名、提交哈希、标签都能用来指定版本
• 直接使用VSCode熟悉的三方合并界面，无需适应新工具

内容的提问来源于stack exchange，提问作者DilithiumMatrix