git配置difftool自定义差异对比工具【攻略】-git-PHP中文网

git difftool 是调用外部工具的胶水命令，需手动配置路径、参数及作用域：windows 注意空格路径和.exe后缀，macos/linux 需确保path或用difftool..path指定完整路径；默认比较工作区与暂存区，--staged比暂存区与head，-d启用目录对比；vs code必须加--wait，winmerge推荐-u和-e，乱码源于autocrlf与工具编码不一致。

git配置difftool自定义差异对比工具【攻略】

Git 本身不自带图形化比对界面，git difftool 只是调用外部程序的“胶水命令”——配错路径、漏传参数、搞混作用域，工具就打不开或只开一半。

怎么让 `git difftool` 找到你的对比工具

根本问题不是工具没装，而是 Git 启动时找不到可执行文件。Windows 用户常因路径含空格或漏写 .exe 后缀失败；macOS/Linux 用户则容易忽略 PATH 是否包含工具所在目录。

先在终端/命令行直接运行工具命令（如 meld、code --wait、winmergeu.exe），确认能正常启动
如果命令失败，说明 PATH 没配好，或者需要绝对路径：比如 macOS 上 VS Code 要用 /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code
配置时优先用 difftool.<tool>.path</tool> 指向完整路径，比依赖 PATH 更稳；例如：git config --global difftool.vscode.path "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code"

`git difftool` 默认比什么、怎么改范围

不带任何参数运行 git difftool，它只比较工作区 vs 暂存区（即 HEAD vs index），且只列出有变更的文件——不是所有修改都会出现，更不会自动比两个 commit。

batch-git-url-replace

批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。

下载

git difftool --staged 或 git difftool --cached：比暂存区和 HEAD
git difftool HEAD~1 HEAD：比两个 commit
git difftool branch-a branch-b：比两个分支最新提交
git difftool -d：进目录对比模式（一次性打开整个项目结构差异）
漏掉 --staged 却以为在看暂存内容，是常见误判来源

为什么工具开了又闪退，或卡住不动

多数卡死或闪退源于参数缺失，尤其 --wait 和 -u 这类“阻塞等待退出”的开关——Git 必须等工具关闭后才继续处理下一个文件。

VS Code 必须加 --wait：配置里写成 code --wait "$LOCAL" "$REMOTE"，否则 Git 会挂起
WinMerge 推荐加 -u（避免多开实例）和 -e（退出后继续执行），否则可能锁住流程
Beyond Compare 4 在 macOS 需要软链 bc3 到 /usr/local/bin/，否则 git difftool 找不到命令
Windows 下路径含空格时，"$LOCAL" 和 "$REMOTE" 的双引号不能省，否则参数解析失败

乱码、换行符错乱、中文显示异常

不是工具问题，是 Git 和工具之间对换行符（CRLF/LF）与文本编码（UTF-8 with BOM / UTF-8）的理解不一致。

统一 Git 行尾设置：git config --global core.autocrlf input（macOS/Linux）或 true（Windows）
Meld 默认用系统 locale 编码，若项目用 UTF-8 无 BOM，需在 Meld 设置里手动指定“Encoding: UTF-8”
VS Code 无需额外配置，但确保工作区设置里 "files.encoding": "utf8"
乱码常出现在首次运行 git difftool 后弹出的确认提示里——那其实是 Git 自己的输出，跟工具无关，不影响实际比对

最易被忽略的是：每次运行 git difftool 前，Git 都会把文件复制进临时目录再传给工具；如果你在工具里直接编辑并保存，改的是临时副本，不会回写到工作区——除非你用的是支持“编辑并合并”的工具（如 vimdiff、kdiff3），且配置了正确的 cmd 模式。