git difftool 是 git diff 的可视化增强层，不改变差异计算逻辑，仅将临时快照交由外部图形工具展示；必须带参数使用，如 git difftool abc123 def456，顺序不可颠倒。

git difftool 不是替代 git diff 的命令，而是它的可视化增强层——它不改变 Git 的差异计算逻辑，只负责把 git diff 生成的临时快照，喂给外部图形工具展示。配置错、路径错、顺序错，都会导致“点开没反应”或“显示空白/错误文件”。

git difftool 命令必须带参数才能对比两个 commit

直接运行 git difftool 默认对比工作区与 HEAD，不是你想看的“两个历史版本”。要对比 abc123 和 def456，必须显式写出：

• git difftool abc123 def456 —— 顺序不能反，否则看到的是“从新到旧”的逆向删减
• 如果只想看某个 HTML 文件，用冒号语法更稳：git difftool abc123:src/index.html def456:src/index.html，避免路径解析歧义
• 加 -d（--dir-diff）可一次性打开整个目录对比，但 Windows 下默认不创建符号链接，得加 --no-symlinks 才能保证右侧显示的是真实内容

Windows 下配 Beyond Compare 要注意路径和引号

在 .gitconfig 里写 cmd 行时，路径含空格必须用双引号包裹，且引号本身要转义（Windows cmd 解析器要求）：

Git Hub Projects V2

使用 gh project CLI 管理 GitHub Projects v2。在代理需要列出待办事项、设置项目字段（如状态、迭代、优先级等）时使用此技能。

下载

[difftool "bc3"]
    cmd = \"C:/Program Files (x86)/Beyond Compare 3/BCompare.exe\" \"$LOCAL\" \"$REMOTE\"

• $LOCAL 和 $REMOTE 是 Git 注入的临时文件路径，不能手动替换
• 若 Beyond Compare 启动后报“文件不存在”，大概率是 $LOCAL 或 $REMOTE 被截断——检查是否漏了反斜杠转义或引号不匹配
• 确保 BCompare.exe 实际存在该路径；新版 Beyond Compare 4 路径可能是 Program Files/Beyond Compare 4，需同步更新配置

HTML 文件用 --color-words 比调外部工具更快

对单个 HTML 文件快速验改，git difftool 反而重——不如用 git diff 加词级高亮：

• git diff --color-words='[^[:space:]]+|]*>' HEAD~1:src/app.html HEAD:src/app.html
• 正则 [^[:space:]]+|]*> 抓取标签和非空格词，跳过换行/缩进扰动
• 如果终端不支持颜色，加 | cat 强制输出，或用 git config --global color.ui always 全局开启
• 注意：这个正则不处理属性值里的引号嵌套（如 title="a & b"），纯文本小改够用；大范围结构变动仍建议用 VS Code 的 GitLens 预览

diff.tool 配置优先级容易被覆盖

diff.tool 的值来源有三处：系统级（/etc/gitconfig）、全局级（~/.gitconfig）、仓库级（.git/config）。后写的会覆盖前写的，但命令行 -t bc3 优先级最高。

• 运行 git config --get diff.tool 看当前生效值，不是看配置文件里有没有写
• 如果 git difftool 总是弹 vimdiff，说明 diff.tool 被某处设为了 vimdiff，查 git config --list | grep diff.tool
• 仓库级配置可被 --no-prompt 或 --dir-diff 等选项绕过，但不会影响 cmd 路径解析逻辑

真正卡住人的，往往不是工具装不上，而是 $LOCAL 和 $REMOTE 这两个变量在配置里被多加了一个空格、少了一个反斜杠，或者路径里混用了正斜杠和反斜杠——Git 不报错，只是静默失败。