Git插件本身不提供图形化文件对比视图，仅调用外部diff工具（如sublime_merge）实现可视化差异；默认仅显示git diff纯文本结果，需正确配置git路径并安装sublime_merge CLI且加入PATH才能启用分栏高亮等图形功能。
Git 插件本身不提供文件对比视图，得靠它调用外部 diff 工具
Sublime Text 的 Git 插件（官方维护版）默认只提供命令行级差异输出，比如在面板里显示 git diff 的纯文本结果，没有并排高亮、滚动同步或点击跳转。它不内置可视化 diff 界面，所谓“Git 差异比对”，实际是靠插件把 git diff 命令的结果喂给 Sublime 的文本视图渲染——所以你看到的只是带 +/− 行号的原始 patch。
如果你想要图形化对比（比如左右分栏、行内变更标记），Git 插件必须配合外部工具，最常见的是 sublime_merge CLI。但注意：sublime_merge 不是插件，而是独立应用；装了插件没装应用，执行 Git: Diff 会直接报错 sublime_merge command not found。
- 确认 Git 插件已安装：命令面板输入
Package Control: Install Package→ 搜Git（注意不是 GitGutter 或 GitSavvy） - 检查 Git 路径是否配置正确：命令面板输
Git: Settings→ User Settings 里确保"git_command"指向真实可执行文件（Windows 常见路径："C:\Program Files\Git\bin\git.exe"） - 想用图形化 diff，必须去官网下载安装完整版
Sublime Merge，安装时勾选Add to PATH，否则插件找不到 CLI
Git: Diff 命令触发后没反应？先看控制台报什么错
按 Ctrl+Shift+D（Windows/Linux）或 Cmd+Shift+D（macOS）执行 Git: Diff 后空白、卡住或闪退，90% 是环境链断裂。打开控制台（Ctrl+`）看第一行错误：
-
fatal: not a git repository→ 当前文件不在 Git 仓库内，或工作目录没识别到.git目录 -
sublime_merge command not found→sublime_mergeCLI 未安装或未加入 PATH，此时插件退回到纯文本 patch 显示（但很多用户根本没注意到那个小面板弹出来了） -
UnicodeDecodeError→ 文件含非 UTF-8 编码内容（如 GBK 日志），Git 插件默认用 UTF-8 解码，失败后静默终止 - 空面板无内容 → 可能当前文件没被 Git 跟踪（
git status显示 untracked），或改动已被暂存（staged），需改用Git: Diff Cached
对比未暂存更改 vs 暂存区，命令完全不同
Git 插件把三种 diff 场景拆成三个独立命令，不能混用：
-
Git: Diff→ 对比工作区（working directory）与暂存区（index），即“还没git add的修改” -
Git: Diff Cached→ 对比暂存区与最近一次 commit（HEAD），即“已经git add但还没git commit的内容” -
Git: Diff All→ 同时显示上述两组差异（分两个面板），适合快速扫一遍所有未提交变更
别指望右键菜单里点“Git → Diff”能自动判断上下文——它只响应当前激活标签页的路径，且严格依赖该路径在 Git 仓库内的相对位置。如果文件是软链接、挂载路径或子模块内，Git: Diff 很可能直接跳过。
大文件或二进制文件 diff 会失败，这不是插件问题
Git 插件底层调用的是系统 git diff，而 Git 默认对大于 50MB 的文件或无法识别为文本的文件（如 .png、.pdf）直接跳过 diff，返回空结果。此时 Sublime 控制台可能只打印一句 fatal: Path 'xxx' exists on disk, but not in the repo，容易误判为插件崩溃。
- 确认文件是否被 Git 跟踪：
git ls-files | grep "your-file" - 强制让 Git 尝试 diff 二进制文件：临时加配置
git config --local diff.external cat（仅调试用，不推荐长期设置） - 真正要对比图片/压缩包等，得切到专用工具（如
meld、diff-pdf），Sublime 的 Git 插件不处理这类场景
Git 插件的 diff 能力本质是 Git CLI 的管道延伸，它不解析语法、不重写换行符、不自动转编码——这些都得靠你提前清理好文件状态。想省事，不如直接用命令行 git diff --no-index file1 file2，再把输出粘进 Sublime 查看。
