VS Code 内置 Diff 工具支持三种高效对比入口:资源管理器多选右键“Compare Files”、命令面板搜索“File: Compare Active File With”、终端调用 git difftool 配合 VS Code 作为外部工具;默认忽略首尾空格差异,可手动关闭 ignoreTrimWhitespace 查看缩进变化;右侧文件默认只读,需启用 diffEditor.inlineEdit 或单独打开编辑。

VSCode 里用 git diff 命令看差异,但别直接敲终端
直接在 VSCode 终端里运行 git diff 只能输出文本,没法点进文件跳转、也没语法高亮。真正直观的比对,得靠编辑器内置的 diff 视图。最稳的方式是:先用命令生成差异元数据,再让 VSCode 自动加载图形化编辑器。
推荐做法是组合使用:
-
git diff --name-only main..feature/login快速确认哪些文件有变更 -
git diff main..feature/login -- src/utils/api.ts看具体文件内容差异(此时 VSCode 会自动识别并启用内联 diff 模式) - 如果终端输出中出现
@@ -15,6 +15,7 @@这类 hunk 头,说明已进入可渲染状态,点击行号左侧的绿色/红色标记就能跳转到对应文件的 diff 视图
注意:git diff 默认不带 --no-index 时,只比较工作区与暂存区或提交,不能跨任意两个路径比——这点常被误用。
配置 git difftool 让 VSCode 弹窗对比任意两个版本
想比两个 commit、或一个 commit 和工作区、甚至两个不同仓库里的同名文件?必须走 git difftool 流程,它会调用外部图形工具,而 VSCode 可以作为这个“外部工具”被注册进去。
关键三步配置(Linux/macOS 终端执行,Windows 请用 PowerShell):
git config --global diff.tool vscodegit config --global difftool.vscode.cmd "code --wait --diff \$LOCAL \$REMOTE"git config --global difftool.prompt false
验证是否生效:git config --get diff.tool 应返回 vscode。之后就能用这些命令了:
- 比两个 commit:
git difftool --no-prompt a1b2c3 d4e5f6 -- src/config.ts - 比当前修改和某次提交:
git difftool --no-prompt HEAD~2 -- package.json - 注意路径必须是相对仓库根目录的,且不能是软链接——
ls -l看到->就得换成真实路径
用 GitLens 的 DiffWith 命令做精准上下文比对
原生 VSCode 的 diff 功能只支持“当前 vs 某个引用”,没法指定某一行或某个函数块。GitLens 的 DiffWith 系列命令补上了这个缺口,比如 GitLens: Compare With… 能让你右键选中一段代码,再选另一个版本中的同一位置进行局部比对。
常见触发场景:
- 右键点击某函数定义 → 选
GitLens: Diff With…→ 选HEAD,立刻看到这个函数最近一次改了哪几行 - 在提交历史视图中,按住
Ctrl(macOS 是Cmd)多选两个提交 → 右键 →Compare Commits,生成结构化差异报告 - 参数
lhs.sha和rhs.uri在底层决定比对粒度;如果你手动调用命令,sha必须是有效提交哈希或HEAD~3这类可解析引用
没装 GitLens?Ctrl+Shift+P 输入 Extensions: Install Extensions,搜 GitLens 装上即可,无需重启。
IDEA 里别依赖 git diff 输出,用 Git4Idea 的 PSI 渲染才是真直观
IntelliJ IDEA 不是把 git diff 的文本结果贴进来完事,而是通过 Git4Idea 插件在 JVM 内用 JGit 解析,再映射到 PSI 树——这意味着它能识别“这个改动发生在 initApp() 函数里”,而不是只标出第 12 行。
所以你在 IDEA 里看到的差异高亮,本质是 AST 级别的语义比对。开启方式很简单:
- 右键文件 →
Git → Compare with Branch…,选目标分支 - 或者直接打开
Local History → Show History,挑两个时间点右键 →Compare with… - 关键设置藏在
Settings → Version Control → Git → Ignore whitespace,默认勾选,但如果你要查空格/换行改动,得临时关掉
容易忽略的一点:Git4Idea 会缓存本地仓库快照,如果刚 git pull 完发现差异没更新,不是 bug,是缓存延迟——点一下右上角的 Refresh 图标(或按 Ctrl+Alt+Y)即可同步。


















