vscode中git.path配置不生效,主因是未完全退出并重启(仅重载窗口无效);windows应选bingit.exe而非cmdgit.exe,路径须用正斜杠或双反斜杠,macos/linux需用homebrew安装路径如/opt/homebrew/bin/git。

VSCode 里 git.path 配置不生效的常见原因
手动填了 git.path 却还是提示 “Git not found”,大概率不是路径写错了,而是 VSCode 没真正加载新配置。VSCode 的 GUI 启动方式(比如从 Dock、开始菜单点开)默认拿不到 shell 的 PATH,即使终端里 git --version 正常,GUI 进程也看不到。最稳的解法是硬编码路径 + 完全退出重开。
- 改完
settings.json后必须关闭所有 VSCode 窗口(包括托盘进程),再重新启动,热重载不触发路径重读 - Windows 用户尤其注意:别用
C:Program FilesGitcmdgit.exe,它缺 SSH 支持,推送到 Gitee/GitHub 时会在认证环节卡住;得选bingit.exe - macOS/Linux 用户如果用 Homebrew 安装 Git,路径通常是
/opt/homebrew/bin/git(Apple Silicon)或/usr/local/bin/git(Intel),别信自动检测给的/usr/bin/git(系统自带,版本旧且常无 credential helper)
怎么快速找到本机 git.exe 或 git 的真实路径
别猜、别翻安装目录,用命令直接定位。不同系统命令不同,但结果唯一:
- Windows(CMD/PowerShell):
where git,输出类似C:Program FilesGitingit.exe - macOS/Linux 终端:
which git或command -v git,输出类似/opt/homebrew/bin/git - 如果输出多行(比如 Windows 同时装了 Git for Windows 和 WSL Git),优先选
bin目录下的那个,它带完整工具链(ssh-agent、git-credential-manager等)
settings.json 中 git.path 的写法细节
JSON 对路径字符串很敏感,斜杠方向和转义容易出错。Windows 路径最容易翻车:
- 正确写法(推荐正斜杠,无需转义):
"git.path": "C:/Program Files/Git/bin/git.exe" - 也可用双反斜杠(单个反斜杠会被 JSON 解析为转义符):
"git.path": "C:\Program Files\Git\bin\git.exe" - 错误写法:
"git.path": "C:Program FilesGitingit.exe"(解析失败,报 JSON syntax error) - macOS/Linux 不需要加
.exe,直接写可执行文件路径即可
GitLens 报 “Git not found” 时优先检查什么
GitLens 是独立插件,它不完全复用 VSCode 内置 Git 设置。如果内置 Git 已通但 GitLens 仍报错,说明它没读到 git.path:
- 先确认 VSCode 设置里
git.path已正确填写并保存(不是只改了工作区设置,要改用户级设置) - 打开命令面板(
Ctrl + Shift + P),运行Git: Show Git Output,看输出面板第一行是不是类似Using git 2.40.1 from /opt/homebrew/bin/git—— 如果是空或报错,说明 VSCode 自身都没连上,GitLens 必然失败 - GitLens 有自己的一套路径查找逻辑,但最终 fallback 还是依赖 VSCode 的
git.path,所以先搞定这个,GitLens 通常就跟着好了











