VSCode 提示 Git 未安装但实际已安装，通常是因为 VSCode 启动时未正确继承系统环境变量 PATH，或设置中 git.path 路径配置错误。优先通过系统终端验证 Git 全局可用性，再手动指定 VSCode 的 Git 路径即可解决。

命令速用版

在系统原生终端（非 VSCode 内置终端）执行以下命令，确认 Git 是否全局可用：

# Windows (CMD/PowerShell)\nwhere git\ngit `--version`\n\n# macOS/Linux\nwhich git\ngit `--version`

若系统终端有输出但 VSCode 内置终端无输出，说明是环境变量继承问题。

为什么会这样

VSCode 作为 GUI 应用，启动时不会自动加载 Shell 配置文件（如 ~/.zshrc 或 profile.ps1），导致 PATH 中缺失 Git 路径。

Windows 上常见原因是 Git 安装时未选择"Add Git to PATH"，或 VSCode 通过开始菜单启动未读取用户级 PATH 更新。macOS 上常见原因是 GUI 应用默认不走 Shell Profile，导致 Homebrew 安装的 Git 路径未被识别。

分步处理

1. 验证 Git 安装状态

打开系统 CMD 或 Terminal，输入 git `--version`。若报错“不是内部命令”，需重新安装 Git 并勾选添加环境变量选项。

2. 配置系统环境变量（Windows）

进入“系统属性” > “环境变量”，在系统变量 Path 中新增 Git 安装路径，通常为 C:\Program Files\Git\bin 或 C:\Program Files\Git\cmd。保存后重启终端验证。

3. 手动指定 git.path（通用方案）

若环境变量配置无效，直接在 VSCode 设置中指定路径。打开设置（Ctrl+,），搜索 git.path，填入 git 可执行文件绝对路径：

// Windows 示例\n"git.path": "C:/Program Files/Git/bin/git.exe"\n\n// macOS 示例\n"git.path": "/opt/homebrew/bin/git"

注意 Windows 路径斜杠可用正斜杠/或双反斜杠\\，必须指向 git.exe 文件而非文件夹。

4. 重启 VSCode

修改配置后完全关闭 VSCode 再重新打开，仅重载窗口可能不生效。

怎么验证是否生效

查看 VSCode 左侧活动栏“源代码管理”图标是否消失红色警告，点击后能否看到“初始化仓库”或现有 Git 仓库文件列表。在 VSCode 内置终端输入 git `--version`，若输出与系统终端一致则修复成功。

常见坑

• 路径错误：Windows 上指向了文件夹而非 git.exe，或路径中包含空格未正确转义。
• 版本过老：macOS 系统自带 Git 版本可能过旧，不支持 VSCode 依赖的参数，建议使用 Homebrew 版本。
• 远程开发：Remote-SSH 连接服务器后 Git 图标灰掉，需检查远程服务器环境变量，重新连接远程窗口而非仅重载。
• 插件冲突：某些 Git 增强插件可能干扰内置 Git 功能，尝试禁用第三方 Git 插件排查。

常见问题

VSCode 内置终端能用的 Git 为什么面板还是报错？

因为 VSCode 主进程启动环境与内置终端 Shell 环境不同，面板调用的是主进程环境变量，需配置 git.path 强制指定。

修改 git.path 后需要重启电脑吗？

不需要重启电脑，但必须完全关闭 VSCode 进程后重新启动，仅点击重载窗口无效。

为什么 Git Bash 里能用，CMD 里不能用？

说明 Git 环境变量只写入了 Git Bash 的局部配置，未写入系统 PATH，需在 Windows 环境变量中手动添加。

参考来源

• 【实战指南】VSCode Git 集成失效排查与修复全流程 (附环境差异分析)
• VSCode 报 Git 未安装是什么错_VSCode 配置环境变量【答疑】
• Git 已安装但 VSCode 未识别
• VSCode 提示"Git 未安装或不在 PATH 中”怎么彻底解决
• 电脑安装了 git 但 vscode 里没有显示安装
• 【解决】:VSCode 中识别不到电脑中的已安装的 Git
• 问题:VS Code 为何无法检测到已安装的 Git?