VS Code可直接作为git difftool开箱即用，关键配置是正确展开$LOCAL与$REMOTE变量并添加--wait参数，路径须为仓库内相对路径，远程SSH需启用X11转发或改用meld等原生GUI工具。
直接用 git difftool 配合 VS Code 就能开箱即用，不用装额外 GUI 工具，也不依赖系统级图形环境（比如远程 SSH 连 Linux 时也能弹窗）。
VS Code 作为 git difftool 的配置要点
关键不是“能不能”，而是配置命令里两个变量是否正确展开：$LOCAL 和 $REMOTE 必须用双引号包裹、且不能漏掉 --wait 参数，否则窗口一闪而过或卡住。
-
git config --global diff.tool vscode—— 告诉 Git 默认用 VS Code 做对比工具 -
git config --global difftool.vscode.cmd "code --wait --diff \$LOCAL \$REMOTE"—— 注意\$LOCAL是转义写法（bash/zsh 下必须），Windows PowerShell 要换成$env:LOCAL等等 -
git config --global difftool.prompt false—— 否则每次执行都问“Launch 'vscode' [y/n]?”，打断流程
git difftool 实际对比时的路径陷阱
报错 fatal: Path 'xxx' does not exist in '<commit>'</commit> 或对比空白，90% 是路径问题。VS Code 不接受绝对路径，也不处理软链接。
- 路径必须是「相对于 Git 仓库根目录」的，比如文件在
src/utils/helper.js，就写src/utils/helper.js，不能写/home/user/proj/src/utils/helper.js - 如果
ls -l显示该路径是软链接，git difftool会失败；得用readlink -f src/utils/helper.js查出真实路径再填进去 - 对比两个 commit 时，顺序影响左右栏：旧版本在左，新版本在右；写反了容易误读增删方向
对比分支差异时别只信 git diff branch1..branch2
这个命令实际比较的是 “branch2 可达、但 branch1 不可达” 的提交引入的变更，不是直观的“两边文件快照差”。想看真实文件级差异，还是得用 git difftool branch1 branch2 -- <path>。
-
git diff branch1...branch2（三个点）才是比较 merge base 到 branch2 的变更，语义更接近“branch2 新增了什么” - VS Code 的内置“Compare Branches”功能（Ctrl+Shift+P →
Git: Compare Branches）底层调的也是类似逻辑，但会自动过滤未修改文件，适合快速扫视 - 如果分支差异大、文件多，
--no-prompt要加，否则每个文件都卡住等你按回车
远程开发（SSH）下 code --wait 弹不出窗口？
不是配置错，是 VS Code Server 没启用图形转发。本地没装 VS Code 桌面版、只靠 remote-ssh 插件时，code 命令默认走 CLI 模式，--diff 会退化成终端输出。
- 必须在远程机器上安装 VS Code 桌面版（.deb/.rpm 或 tarball），并确保
code命令指向它（而非code-server） - SSH 连接要带
-X或-Y参数启用 X11 转发，且远程系统已安装 X server（如xorg） - 更稳的替代方案：用
git difftool -t meld（需提前sudo apt install meld），meld 是原生 GTK 应用，对 X11 兼容性更好
真正麻烦的从来不是“怎么打开对比窗口”，而是确认你比的确实是那两个版本、那个路径、那个文件状态——git difftool 不校验工作区干净与否，HEAD 和 index 的差异混在一起时，结果容易误判。
