vscode 找不到 git 的主因是路径未正确配置或环境变量未继承。需先验证系统终端能识别 git,再确保 vscode 启动方式继承 path,或手动配置 git.path 并完全重启 vscode。

VSCode 找不到 git,90% 是它压根没看到你系统里那个 git.exe 或 git——不是没装,是路径没对上、没继承、或填错了。
确认 Git 真的装好了,且系统能认
别跳过这步。很多问题卡在“我以为装了”。打开系统原生终端(不是 VSCode 里的终端):
- Windows:CMD 或 PowerShell 里运行
where git,有输出(比如C:Program FilesGitingit.exe)才算真装对 - macOS/Linux:运行
which git,返回类似/usr/local/bin/git或/opt/homebrew/bin/git才算到位 - 如果没输出,说明 Git 没进系统 PATH,或根本没装——去官网下载,安装时务必勾选 “Add Git to the system PATH”,别选 “Only use Git from Git Bash”
VSCode 启动方式决定它能不能看到 PATH
从开始菜单、Dock 或桌面图标启动 VSCode,大概率不会加载 shell 的环境变量(尤其是 macOS 和 Windows 用户级 PATH 更新后未重启资源管理器):
- macOS:必须在 Terminal 里运行
code启动 VSCode,才能继承~/.zshrc或~/.bash_profile里的 PATH - Windows:用 CMD/PowerShell 运行
code启动更可靠;若坚持用开始菜单,得确保 Git 路径已加到系统环境变量(不是用户变量),并重启资源管理器或整机 - 验证方法:在 VSCode 内置终端里运行
echo %PATH%(Windows)或echo $PATH(macOS/Linux),看输出里有没有 Git 安装目录
手动配 git.path 是最稳的兜底方案
当 PATH 不可控(比如公司锁死环境、多版本 Git 共存),直接告诉 VSCode 去哪找 git:
- Windows 推荐路径:
C:/Program Files/Git/bin/git.exe(不是cmd/git.exe,后者缺 SSH 支持,推送到 GitHub/Gitee 会卡认证) - macOS(Homebrew):
/usr/local/bin/git或/opt/homebrew/bin/git - Linux:
/usr/bin/git或/usr/local/bin/git - 路径分隔符必须用正斜杠
/或双反斜杠\,单反斜杠在 JSON 里会转义失效 - 填完保存,必须完全退出 VSCode(关掉所有窗口),再重开——热重载不生效
VSCode 终端里 git 还是报 command not found?
即使 git.path 配好了,内置终端也可能用不上系统 PATH:
- 检查设置中
terminal.integrated.env.windows(Windows)或terminal.integrated.env.linux(Linux/macOS)是否为空 - 在
settings.json里手动补上 Git 路径,例如:"terminal.integrated.env.windows": { "PATH": "C:/Program Files/Git/bin;${env:PATH}" } - 或者换终端类型:设
terminal.integrated.defaultProfile.windows为Git Bash(前提是 Git 安装带 Bash,且路径指向bash.exe,不是git.exe)
最容易被忽略的是:改了系统 PATH 后没重启 VSCode,或者填了 cmd/git.exe 还以为没问题——它真就不支持 SSH 认证,远程操作会静默失败。











