如何在VS Code中配置Git插件 常用版本管理工具

直接说结论，全球最火的那款代码编辑器，从来不自带 Git。它和 Git 的相处模式，说起来很简单，但理解错的人相当多：所谓的“Git 插件”，本质上不是安装了一个新程序，而是 VS Code 在你的系统里找到了你原本就装好的那个 git，然后跟它建立了连接。所以，一旦 SCM 视图灰掉——分支不显示、按钮点不了，核心原因不是“插件坏了”，而是 VS Code 找不到或者用不上你那个 git 可执行文件。路径没配好、环境变量没继承到，哪一个都够你卡半天。

先拿到一个铁证——VS Code 到底有没有认出来系统里的那个 git

这一步是根本，绝大多数“Git 在 VS Code 里罢工了”的求助帖，卡住的位置就在这里。

• 在 VS Code 内置终端按下 Ctrl + `，输入 git --version。如果能看到类似 git version 2.40.1 的输出，说明终端层面是通的。一旦报出 command not found，那就不是 VS Code 的问题了——你需要检查自己的 shell 配置（比如 ~/.zshrc、~/.bash_profile），确保它导出了正确的 PATH。
• 更直接的验证方式：按 Ctrl + Shift + P，调用命令面板，输入 Git: Show Git Output。在弹出的输出面板里，仔细找一找，如果看到一个类似 Using git 2.40.1 from /usr/bin/git 的行，那就说明 VS Code 正确地找到了你的 Git。如果显示的是 Git not found 或者路径直接为空，那就说明配置没有生效。
• Windows 用户有一条特别容易踩的坑：在设置中指定 git.exe 时，千万要选 C:\Program Files\Git\bin\git.exe。那个 cmd\git.exe 路径虽然也能找到，但缺少 SSH 支持，你把代码推到 Gitee 或 GitHub 时，大概率会卡在认证环节，摸不着头脑。

手动锁定 git.path，一个最可靠的兜底操作

哪怕你在终端里敲 git 一切正常，也不要大意。因为 VS Code 的 GUI 进程在启动时，有可能拿不到你在终端里已经配好的那些 PATH 变量——这在 macOS 和 Linux 上尤其常见。直接指定一个绝对路径，才是真正一劳永逸的解法。

• 打开设置（Ctrl + ,），直接搜索 git.path。
• 点击“在 settings.json 中编辑”，写下 Git 可执行文件的绝对路径。举个例子：

"git.path": "/opt/homebrew/bin/git"

（macOS 上通过 Homebrew 安装的 Git，路径就是这个）

"git.path": "C:/Program Files/Git/bin/git.exe"

（Windows 系统上，注意要用正斜杠或者双反斜杠）

• 这一点非常重要：保存完 settings.json 之后，**必须完整地退出 VS Code——关闭掉所有窗口——然后再重新打开**，热重载在这个设置上是不生效的。

关于日常暂存和提交，那个“+”按钮不是你以为的那回事

不少新手都会习惯性地用 SCM 视图里每个文件旁边的 “+” 来做暂存。但它的行为并不等同于 git add -A。真相是：这个 “+” 按钮，只会添加那些**从未被跟踪过的**新文件。已经修改过的、被重命名的、被删除的文件，它理都不会理。这也不是一个 Bug，而是它设计时就如此。

• 想一次性暂存所有改动：正确的做法是在某个已修改文件上点击右键，选择 Stage Changes；或者直接用命令面板（Ctrl + Shift + P）执行 Git: Stage All。
• 如果只想丢弃文件中的某一段修改，而非整个文件：在 SCM 视图里点开那个文件，找到改动的那一行，鼠标悬停在这个行号的右侧——会出现一个 ⋯ 的菜单，选中 Revert Selected Ranges，就只回滚这一段，不影响文件其他部分。
• 提交消息支持多行输入：按下 Ctrl + Enter 就可以提交。如果你在设置里勾选了 git.alwaysSignOff，每次提交会自动带上 Signed-off-by 签名，对于团队协作中的合规性很有帮助。

处理合并冲突时，按钮上的文本和它的视觉位置是反的

这是 VS Code 里一个非常容易导致误操作的设计细节。合并编辑器打开后，左侧默认显示远端的变更（Incoming），右侧显示你本地的变更（Current）。但问题是，“Accept Current Change”的这个按钮，被放在了右侧——也就是“本地”那一侧。一着急点错了，你辛辛苦苦写的本地代码就全没了。

• 先看一眼右下角的状态栏：它会显示你当前在哪个分支上。比如显示 main，就表明这个分支的内容就是“Current”。
• 要牢记这些按钮的真实语义：Accept Current Change 的意思是保留你本地的，丢弃远端的；Accept Incoming Change 则是反过来，丢弃你本地的，全盘接受远端的。这两个按钮是互斥操作，按之前一定要想清楚。
• 最稳妥的策略：先不急着选边，而是点一下 Accept Both Changes 按钮。两边的内容都会保留下来。然后再手动去删掉那些重复的 JSON 字段、重复的 import 行，遇到配置文件的增删改动时，这种方式能最大程度地避免遗漏。
• 最后一步别漏掉：所有冲突块都处理完毕后，编辑器顶部会出现一个 ✓ 完成合并 的按钮，必须点它。如果不点，就算你自己觉得已经没问题了，git status 依然会报告“尚未合并”，提交也是提交不了的。

Git 在 VS Code 里的表现，说到底没有太多玄学。它的稳定性、它能做的事情的上限，全取决于你配给它的那个 git 可执行文件是不是干净的、路径是不是锁死的、SSH 密钥是不是就位的。别在编辑器界面里翻来翻去找答案，直接打开终端和 settings.json，盯住那几行真实的配置信息，问题往往就能迎刃而解。