git merge工具配置不生效主因是作用域错误，需检查--local/--global配置优先级，删仓库级干扰项并正确设置code命令路径及meld三路参数。
Git merge工具配置不生效？先确认是不是git config作用域错了
很多人配完meld或vscode，执行git mergetool还是弹出vimdiff——大概率是配置写到了错误的作用域。git config有三个层级：--local（当前仓库）、--global（当前用户）、--system（全系统），而mergetool默认只读--local和--global，但优先取--local。如果当前仓库里已有冲突相关的旧配置（比如merge.tool被设成vimdiff），它就会覆盖全局设置。
- 查当前生效的
merge.tool：运行git config --get-regexp 'merge\|diff' - 强制写入全局配置：用
git config --global merge.tool <code>meld（注意别漏--global） - 删掉仓库级干扰项：
git config --unset merge.tool（在项目根目录下运行）
用VS Code做mergetool，git mergetool报错“command not found”
VS Code本身不是命令行工具，必须通过code命令调用，而这个命令默认不加入$PATH——尤其在macOS的GUI终端、Windows的Git Bash里最常见。错误信息通常是sh: code: command not found或The merge tool <code>vscode is not available。
- macOS：打开VS Code →
Cmd+Shift+P→ 输入“Shell Command: Install 'code' command in PATH”并执行 - Windows：安装时勾选“Add to PATH”，或手动把
C:\Users\<code>用户名\AppData\Local\Programs\Microsoft VS Code\bin加进系统环境变量 - 验证：终端输入
code --version能返回版本号才算成功 - 配置命令：用
git config --global mergetool.vscode.cmd 'code --wait --merge $LOCAL $REMOTE $BASE $MERGED'
meld启动后不显示冲突块，只显示三路文件视图
这是meld默认行为：它不会自动高亮冲突标记（如），而是依赖Git把冲突内容拆解为<code>LOCAL/REMOTE/BASE三个临时文件传给它。如果看到纯文件对比、没合并面板，说明Git没正确生成中间文件，或meld没收到完整参数。
- 检查meld是否支持三路合并：
meld --help | grep -i merge应输出含--auto-merge或类似字样 - 确保Git传递了全部四个路径：
git config --global mergetool.meld.cmd 'meld "$BASE" "$LOCAL" "$REMOTE" "$MERGED"'（注意引号和顺序） - Windows用户注意路径分隔符：用
"$BASE" "$LOCAL"而非$BASE $LOCAL，否则空格路径会截断 - 首次运行后，meld会在右上角提供“Accept Local/Remote”按钮，这才是真正的冲突解决入口
为什么git mergetool有时跳过文件，有时卡住不动
根本原因是Git对“是否需要合并工具”的判断逻辑：它只对状态为unmerged的文件调用mergetool。如果你手动删了冲突标记、或用编辑器保存了部分解决后的文件，Git会认为该文件已“resolved”，不再触发工具。而卡住通常是因为工具进程没正常退出（比如meld关了窗口但后台进程还在），Git就一直等返回码。
- 强制重置所有冲突状态：
git checkout -m -- .（重新拉回冲突态） - 避免中途退出：用
git mergetool --no-prompt跳过确认，或配git config --global mergetool.keepBackup false减少干扰 - 排查卡死：
ps aux | grep meld（macOS/Linux）或任务管理器（Windows），杀掉残留进程再试 - 注意：某些GUI工具（如VS Code）关闭窗口即退出；meld则要点击“Save”并关闭主窗口才算完成
真正麻烦的是跨平台协作时，不同人用的mergetool对行尾符、编码、空格处理不一致——这些细节不会报错，但会导致下一次git diff突然多出几百行变化。配完别急着提交，先git status看是不是只有你预期修改的文件被标为modified。
