git difftool需手动配置外部工具命令，不同系统要注意路径、参数和编码：vs code需--wait，beyond compare需软链bc3，meld直接调用；行为由参数决定，如无参数只比工作区与暂存区；windows需处理空格路径和.exe后缀；乱码源于换行符与编码不一致，应统一autocrlf并设置工具编码。
怎么让 git difftool 启动 Beyond Compare（或 VS Code、meld）
Git 本身不带图形化比对界面，difftool 只是调用外部程序的“开关”，得手动告诉它用哪个命令、传什么参数。Windows 用户常卡在路径空格或.exe后缀没写全，macOS 用户容易忽略code --wait里必须加--wait，否则 Git 会卡住不动。
- VS Code：
git config --global difftool.vscode.cmd 'code --wait --diff "$LOCAL" "$REMOTE"' - Beyond Compare（macOS）：
git config --global difftool.bc3.cmd 'bc3 "$LOCAL" "$REMOTE"'（需先软链bc3到/usr/local/bin/） - meld（Linux）：
git config --global difftool.meld.cmd 'meld "$LOCAL" "$REMOTE"' - 所有配置后，首次运行
git difftool会提示是否每次跳过确认，输y即可
为什么 git difftool 有时只打开一个文件、有时打开整个暂存区
行为取决于你调用时的上下文——Git 不自动猜你要比什么，它严格按命令范围执行：
-
git difftool（无参数）：默认比工作区和暂存区（即HEADvsindex），只列出有变更的文件 -
git difftool HEAD~1：比当前工作区和上一个提交，可能打开多个文件 -
git difftool --staged：比暂存区和HEAD，也就是已git add但未提交的内容 - 如果只比某个文件，必须显式指定：
git difftool path/to/file.js
漏掉参数或误用--staged会导致“明明改了三处，工具却只开一个窗口”。
Windows 上用 WinMerge 或 TortoiseGitMerge 遇到“command not found”
根本原因不是软件没装，而是 Git 找不到可执行文件路径。WinMerge 默认不加环境变量，TortoiseGitMerge 的TortoiseGitMerge.exe常藏在 Program Files 带空格的路径里，Git shell 默认不处理引号包裹。
- 安全做法：用绝对路径 + 双引号包裹，并确保
.exe后缀明确：git config --global difftool.winmerge.cmd '"C:/Program Files/WinMerge/WinMergeU.exe" -e -u -dl "Local" -dr "Remote" "$LOCAL" "$REMOTE"' - 更省事：把 WinMerge 安装目录加进系统
PATH，然后配简短命令：git config --global difftool.winmerge.cmd 'winmergeu.exe -e -u -dl "Local" -dr "Remote" "$LOCAL" "$REMOTE"' - 注意
-u参数：避免 WinMerge 多开实例；-e保证退出后 Git 继续执行
diff 工具配好了，但中文乱码、换行符显示异常
这不是 Git 的锅，是外部工具读文件时编码或换行符检测错了。尤其 Windows 和 macOS 混合协作时，CRLF vs LF + GBK vs UTF-8 极易打架。
- VS Code 默认 UTF-8，但若仓库用
core.autocrlf=true（Windows 默认），Git 会悄悄转CRLF，而 Code 读取$LOCAL时可能仍按 LF 解析——结果空行变多、末尾多^M - 解决办法：统一用
core.autocrlf=input（macOS/Linux 推荐）或false（禁用自动转换），再在 VS Code 设置里关掉files.autoGuessEncoding - Beyond Compare 可在
Tools > Options > File Formats里为*.js等后缀强制指定 UTF-8 编码
乱码问题往往拖到合并冲突时才暴露，但根子在 difftool 启动那一刻就埋下了。
