Windows下配置VSCode为Git Difftool和Mergetool的报错解决

先排查前置条件 #

确保VSCode的code命令能在终端正常运行：

• 打开VSCode，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板
• 搜索并执行Shell Command: Install 'code' command in PATH
• 重启终端后，输入code --version验证，能输出版本号则说明配置成功

正确配置Git（两种方式二选一） #

方式1：用命令行全局配置（所有仓库生效）

在终端依次执行以下命令：

# 清除可能残留的错误配置
git config --global --unset merge.tool

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

# 配置difftool
git config --global diff.tool vscode
git config --global difftool.vscode.cmd 'code --wait --diff $LOCAL $REMOTE'
git config --global difftool.prompt false

方式2：手动编辑Git配置文件

找到全局配置文件（Windows：C:\Users\<你的用户名>\.gitconfig；Linux/Mac：~/.gitconfig），替换或添加以下内容：

[merge]
    tool = vscode
[mergetool "vscode"]
    cmd = code --wait $MERGED
    trustExitCode = false
[diff]
    tool = vscode
[difftool "vscode"]
    cmd = code --wait --diff $LOCAL $REMOTE
[difftool]
    prompt = false

关键配置说明 #

• trustExitCode = false：避免Git因VSCode的退出码判断错误，确保合并操作正常完成
• difftool.prompt = false：跳过每次调用difftool时的确认提示，直接打开VSCode

验证配置 #

• 测试difftool：执行git difftool HEAD~1，VSCode应自动打开并显示当前版本与上一版本的差异
• 测试mergetool：手动创建一个合并冲突场景（比如分支间修改同一文件同一行），执行git mergetool，VSCode会打开并允许你处理冲突

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