VSCode Git Bash 终端：告别内置vi，直接用VSCode编辑交互内容

在使用VSCode搭配Git Bash终端时，很多开发者会遇到一个小困扰：执行需要交互编辑的Git命令（如无-m参数的git commit）时，终端会自动打开内置的vi编辑器，操作起来不够便捷，且与VSCode主编辑器的使用习惯脱节。其实，我们只需简单配置，就能让Git交互编辑直接调用VSCode主编辑器，提升开发效率，本文将详细梳理配置过程及注意事项。

一、问题背景

默认情况下，在VSCode的Git Bash终端中执行需要交互编辑的命令（例如git commit，未添加-m参数指定提交信息时），Git会调用终端内置的vi编辑器，用于编写提交信息等内容。但vi编辑器的操作逻辑与VSCode差异较大，对于习惯了VSCode编辑体验的开发者来说，频繁切换操作方式会影响效率，因此需要将Git的默认编辑器替换为VSCode。

二、核心实现思路

实现的核心的是两步：一是让Git Bash终端能够识别VSCode的命令行指令，二是将Git的默认编辑器配置为VSCode，并让Git等待编辑完成后再继续执行命令。其中，关键参数--wait不可或缺，它能确保Git不会在VSCode打开后立即结束交互，而是等待我们编辑并关闭文件后再继续执行后续操作。

三、详细配置步骤

步骤1：安装VSCode命令行工具（code命令）

要让Git Bash能够调用VSCode，首先需要将VSCode的code命令添加到系统环境变量中，具体操作如下：

打开VSCode编辑器；
按下Ctrl+Shift+P组合键，打开命令面板；
在命令面板中输入并选择「Shell Command: Install 'code' command in PATH」；
等待系统提示安装成功即可（Windows系统下，Git Bash会自动识别该命令，无需额外配置环境变量）。

步骤2：配置Git默认编辑器为VSCode

打开VSCode中的Git Bash终端，根据需求选择以下配置方式（推荐全局配置，一次配置永久生效）：

方式1：全局配置（推荐）

执行以下命令，全局设置Git的默认编辑器为VSCode，所有Git仓库都会生效：

css 复制代码

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

方式2：临时配置（仅当前终端会话）

如果仅需要在当前终端会话中生效，执行以下命令（关闭终端后配置失效）：

arduino 复制代码

git config core.editor "code --wait"

四、配置验证方法

配置完成后，建议通过以下步骤验证是否生效，避免后续使用时出现问题：

检查配置是否成功：在Git Bash终端中执行以下命令，查看当前Git默认编辑器配置；

arduino 复制代码

git config --global --get core.editor

若输出为code --wait，则说明全局配置成功；若未配置全局，可去掉--global参数查看当前仓库配置。

测试交互编辑功能：进入任意一个Git仓库，修改一个文件后，执行以下命令触发交互编辑；

csharp 复制代码

git add .
git commit  # 不添加-m参数，触发提交信息编辑

正常情况下，VSCode会自动打开一个名为「COMMIT_EDITMSG」的文件，此时可在VSCode中直接编写提交信息，保存文件并关闭该标签页后，Git会自动完成commit操作，说明配置生效。

五、常见问题及解决方案

配置过程中或测试时，可能会遇到一些问题，以下是常见问题及对应的解决方法：

问题1：执行git commit后，未打开VSCode，仍使用vi编辑器或报错；解决方案：重启Git Bash终端（让code命令的环境变量生效），重新执行步骤1安装code命令，或检查VSCode是否为最新版本，更新后重试。
问题2：打开VSCode编辑后，Git未继续执行操作；解决方案：确认编辑完成后，保存并关闭VSCode中的「COMMIT_EDITMSG」标签页（仅保存不关闭无效），Git会在标签页关闭后继续执行。
问题3：Git Bash中提示「code: command not found」；解决方案：重新执行步骤1，确保「Shell Command: Install 'code' command in PATH」操作成功，若仍失败，可手动将VSCode安装目录下的「bin」文件夹添加到系统环境变量PATH中。

六、总结

通过以上简单两步配置，就能彻底解决VSCode Git Bash终端中交互编辑依赖vi的问题，让Git交互操作与VSCode编辑体验无缝衔接。核心要点如下：

必须先安装VSCode的code命令行工具，确保Git Bash能识别并调用VSCode；
配置Git默认编辑器时，--wait参数是关键，用于让Git等待编辑完成；
测试时，编辑完成后需关闭VSCode中的目标文件标签页，Git才会继续执行后续命令。

该配置适用于所有需要Git交互编辑的场景（如git rebase -i等），配置完成后，能有效提升开发过程中的操作流畅度，尤其适合习惯VSCode编辑环境的开发者。如果在配置过程中遇到其他问题，欢迎在评论区留言交流～