如何设置 Git 默认文本编辑器？

你是不是也经历过这样的场景：在终端里敲下 git commit，回车，然后屏幕突然跳转到一个完全陌生的界面，光标在闪，键盘却好像失灵了，完全不知道如何输入、保存，甚至是如何退出？

别慌，你大概率是闯入了 Git 默认的文本编辑器——Vim 或 Nano 的世界。

对于不熟悉它们的人来说，这确实是个不小的打击。但好消息是，你完全可以将 Git 的默认编辑器修改为你每天都在使用的、最顺手的代码编辑器，比如 Visual Studio Code、Sublime Text 等。这只需要一行命令。

这篇文章就是你的“救星”，它会提供清晰、可直接复制的命令，让你彻底掌控 Git 的编辑体验。

核心命令：git config

Git 的所有配置都由 git config 命令管理。要修改默认编辑器，我们真正需要关心的配置项是 core.editor。

通用的设置命令格式如下：

git config --global core.editor "你的编辑器的启动命令"

这里的 --global 参数非常关键，它意味着这个设置将应用于你电脑上所有的 Git 仓库。如果你只想为当前项目设置，去掉它即可。

听起来很简单？没错。但魔鬼在细节里——每个编辑器的“启动命令”都略有不同。下面，我们为你准备了主流编辑器的精确指令。

主流编辑器设置指南 (直接复制粘贴)

找到你正在使用的编辑器，复制对应的命令到你的终端里执行，就大功告成了。

1. Visual Studio Code (VS Code)

VS Code 是目前最受欢迎的选择。要将其设置为 Git 编辑器，一个关键参数是 --wait，它会告诉 Git 等待你关闭编辑器窗口后再继续操作。

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

提示： 如果这个命令无效，请先确保你已经在 VS Code 中执行过 Shell Command: Install 'code' command in PATH 操作。打开 VS Code，使用 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (Mac) 打开命令面板，输入 Shell Command 就能找到该选项。

2. Sublime Text

Sublime Text 用户同样需要使用一个等待参数 -w。

git config --global core.editor "subl -n -w"

• -n: 在新窗口中打开文件。
• -w: 等待文件关闭。

3. Atom

Atom 的设置和 VS Code 非常相似，也是使用 --wait 参数。

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

4. Notepad++ (Windows 用户)

如果你是 Windows 用户且偏爱 Notepad++，路径中可能包含空格，需要用额外的引号包裹。

# 路径可能因你的安装位置而异，请自行检查
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"

5. Vim 或 Neovim

当然，如果你就是 Vim 的忠实粉丝，或者想使用更现代的 Neovim (nvim)，你也可以明确地设置它。

# 设置 Vim
git config --global core.editor "vim"
# 设置 Neovim
git config --global core.editor "nvim"

如何验证设置是否成功？

想知道你的设置生效了吗？有两种方法可以检查。

1. 查看配置 在终端输入以下命令，看看输出是否是你刚刚设置的编辑器命令：

   git config --global core.editor

2. 实战演练 找一个你的 Git 项目，做一些修改，然后运行一个不带 -m 参数的 git commit：

   # (先做一些文件修改)
   git add .
   git commit

   如果 Git 成功打开了你设置的 VS Code 或其他编辑器，让你输入 commit message，那么恭喜你，设置成功！

常见问题 (FAQ)

Q1: 我设置了 VS Code，但 Git 没有等待我保存就继续了，怎么办？

A: 这几乎可以肯定是 你忘记了添加 --wait 参数。Git 需要这个信号来暂停并等待你的编辑操作完成。请重新运行正确的命令：git config --global core.editor "code --wait"。

Q2: 如何恢复到 Git 的默认编辑器？

A: 如果你想“重置”设置，让 Git 自己决定用什么编辑器（通常是系统环境变量 EDITOR 指定的，或者默认的 Vim），可以使用 --unset 命令：

git config --global --unset core.editor

Q3: 我可以在不同的项目中使用不同的编辑器吗？

A: 当然可以。--global 参数是全局设置。如果你想在某个特定项目中用不同的编辑器，只需进入那个项目的根目录，然后运行一个 不带 --global 的设置命令即可。项目级别的配置会覆盖全局配置。

# 进入你的项目目录
cd /path/to/my-special-project
# 为这个项目单独设置 Atom 编辑器
git config core.editor "atom --wait"

Q4: 为什么不直接用 git commit -m "message" 更方便？

A: 对于简单的、一句话的提交，git commit -m "..." 非常高效。但当你需要编写更规范、更详细的 Commit Message 时（比如，包含标题、空行和详细描述的正文），调用一个完整的文本编辑器会提供更好的体验。这有助于团队协作和后续的代码追溯，是专业开发的好习惯。

现在，你的 Git 工作流完全由你掌控了。去试试 git commit，享受在你最熟悉的编辑器里书写提交信息的顺畅感觉吧！