1. 现象与典型痛点

在没有调校过 Git 配置的新环境或容器中协作时，经常陷入三类典型场景：

1. 终端“卡死”误入 nano/vim：在执行 git commit（遗漏 -m）或交互式 git rebase -i 时，终端直接切入 nano 或 vim，快捷键不熟悉时甚至连保存退出都成问题。
2. 文本级 Diff 难以快速识别结构变动：终端里 git diff 刷出海量红绿字符，单屏跨行对比十分吃力，且无法像 IDE 一样折叠代码上下文。
3. 冲突解决犹如“开盲盒”：分支合并产生冲突后，代码中满是 <<<<<<< HEAD、=======、>>>>>>> branch，手动清理不仅耗时，还容易把同事的必要逻辑误删。

2. 核心机制与参数解析

Git 提供了对外部编辑器与可视化对比/合并工具的原生调度接口：

3. 配置方法

方式一：终端命令行一键注入（推荐）

打开终端，依次执行以下命令完成全局注入：

1. 设置 VS Code 为全局默认编辑器

1

git config --global core.editor "code --wait"

2. 配置可视化 Diff 工具

1
2

git config --global diff.tool vscode
git config --global difftool.vscode.cmd 'code --wait --diff "$LOCAL" "$REMOTE"'

3. 配置三方 Merge 工具

1
2
3
4

git config --global merge.tool vscode
git config --global mergetool.vscode.cmd 'code --wait --merge "$REMOTE" "$LOCAL" "$BASE" "$MERGED"'
git config --global mergetool.trustExitCode true
git config --global mergetool.keepBackup false

4. 配置高频实用别名（Alias）

1
2
3
4
5
6
7
8

git config --global alias.dt "difftool -y"


git config --global alias.dtd "difftool -y --dir-diff"


git config --global alias.mt "mergetool -y"

方式二：直接编辑全局 .gitconfig

执行 git config --global --edit，将以下配置块合并保存：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

[core]
    editor = code --wait

[diff]
    tool = vscode

[difftool "vscode"]
    cmd = code --wait --diff "$LOCAL" "$REMOTE"

[merge]
    tool = vscode

[mergetool "vscode"]
    cmd = code --wait --merge "$REMOTE" "$LOCAL" "$BASE" "$MERGED"
    trustExitCode = true
    keepBackup = false

[alias]
    dt = difftool -y
    dtd = difftool -y --dir-diff
    mt = mergetool -y

4. 验证与实战操作流

1. 验证基础编辑器

执行不带任何参数的 commit 命令：

1

git commit

VS Code 会弹出一个名为 COMMIT_EDITMSG 的标签页。在其中输入提交信息，按 Ctrl + S（或 Cmd + S）保存，然后关闭该标签页（Ctrl + W / Cmd + W），终端立即完成提交。

2. 差异对比：普通对比 vs 目录级全量对比

逐文件比对：

1
2

git dt
git dt HEAD~1

多文件批量比对（强烈推荐）：

1

git dtd

执行后，VS Code 会在左侧资源管理器中展开一个虚拟文件夹，将所有变动文件列出，点击任一文件即可直接在主区域查看差异，不必在终端来回回车确认。

3. 冲突解决：3-Way Merge 交互

当 git merge 或 git rebase 提示冲突时，运行：

1

git mt

VS Code 会自动打开冲突文件的 3-Way Merge Editor：

• 顶部左侧：Incoming（传入的更改）
• 顶部右侧：Current（本地当前的更改）
• 底部窗口：Result（最终生成的合并结果）

在勾选框中直观点击选择采用哪一方的改动，确认底部无误后点击右下角 Complete Merge，再关闭窗口，Git 即自动标记冲突已解决。

5. 注意事项与避坑

1. 确保 code 命令已被加入环境变量 PATH：若终端报错 command not found: code，在 VS Code 中按快捷键 Ctrl + Shift + P（macOS 对应 Cmd + Shift + P），搜索并运行：Shell Command: Install 'code' command in PATH。
2. 切记关闭文件标签页（Close Tab）：许多开发者保存后没有关闭标签页，导致终端一直处于阻塞等待状态。这是 --wait 的正常机制，只有关闭标签页通知才能结束进程。
3. 环境变量优先级覆盖问题：若配置后仍被强制唤起 nano/vim，请检查 ~/.bashrc 或 ~/.zshrc 中是否存在 export EDITOR="..." 或 export VISUAL="..."。Shell 环境变量的优先级高于 Git 本地全局配置，将其统一修改为 export EDITOR="code --wait" 即可。