VSCode终端Git Bash配置重置教程

秋敏姑娘_5613

秋敏姑娘_5613

2026-11-13

438人浏览

原创

重置比“修配置”更可靠,因90%异常源于profile名称不一致、args冲突或非法JSON;删掉terminal.integrated.profiles.windows和defaultProfile.windows后,VSCode会自动扫描系统识别Git Bash。

vscode终端git bash配置重置教程

VSCode 终端 Git Bash 配置失效时,直接删掉 terminal.integrated.profiles.windows 和 terminal.integrated.defaultProfile.windows 两行就能重置为默认行为——不是回退到 CMD,而是让 VSCode 重新扫描系统、自动识别已安装的 Git Bash。

为什么重置比“修配置”更可靠

90% 的终端配置异常,根源不是写错路径,而是 profile 名称不一致、args 冲突、或残留了被 VSCode 忽略的非法 JSON(比如 trailing comma、中文引号、路径含未转义空格)。手动改配置容易陷入“改一点、试一次、没反应、再猜”的循环。重置后 VSCode 会按内置规则重新探测:git-bash.exe 是否在注册表或常见路径(如 C:Program FilesGitgit-bash.exe、%LOCALAPPDATA%ProgramsGitgit-bash.exe)下存在,且可执行。

重置操作本身只需两步:

  • 打开命令面板(Ctrl + Shift + P),输入并选择 Preferences: Open Settings (JSON)
  • 删除包含 terminal.integrated.profiles.windows 和 terminal.integrated.defaultProfile.windows 的整行(注意保留其他配置,别误删花括号外的逗号)
  • 保存文件,关闭所有终端面板,再用 Ctrl + Shift + ` 新建一个

重置后 VSCode 仍不显示 Git Bash 选项

说明它没扫描到有效的 git-bash.exe。这不是配置问题,是路径或安装状态问题。检查以下几点:

  • 确认 Git for Windows 已安装,且安装时勾选了 “Use Git and optional Unix tools from the Command Prompt”(否则 git-bash.exe 可能未被写入注册表)
  • 运行 where git-bash 或 where git-bash.exe(在 CMD/PowerShell 中),看是否返回路径;若无结果,说明不在系统 PATH,需手动定位
  • 常见有效路径优先试:C:Program FilesGitgit-bash.exe、C:Users{用户名}AppDataLocalProgramsGitgit-bash.exe、D: oolsgitgit-bash.exe(根据你实际安装盘符调整)
  • 不要用 bash.exe 或 sh.exe 替代——它们启动后不自动映射 Windows 路径(cd c:/project 会失败),VSCode 也不认它们为合法 Git Bash profile

必须手动配 profile 时的关键细节

当重置无效、又必须硬配时,settings.json 里这几处写错就白配:

GitHub一键发布助手(专业版)
GitHub一键发布助手(专业版)

本地项目发布到GitHub的完整工作流助手。自动执行:安全检查(.gitignore、排除敏感.env/凭据文件)、补齐开源文件(LICENSE、.gitignore)、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词:"发布到GitHub"、"上传到github"、&quot

下载
  • "path" 值必须是 git-bash.exe 的**完整绝对路径**,且用双反斜杠 \ 或正斜杠 /(例如 "D:\Git\git-bash.exe" 或 "D:/Git/git-bash.exe"),不能混用
  • profile 名称(如 "Git Bash")必须和 terminal.integrated.defaultProfile.windows 的值逐字完全一致,包括空格、大小写——VSCode 下拉菜单里显示什么,这里就写什么
  • 加 "args": ["--login", "-i"] 才能加载 ~/.bashrc,否则 git、ssh 等命令可能报 command not found
  • 如果路径含中文或空格(如 C:My ToolsGitgit-bash.exe),JSON 不会报错但会静默忽略整条 profile;建议重装 Git 到无空格路径(如 C:Git)

新终端还是开成 PowerShell?不是配置没生效,是复用了旧实例

VSCode 的终端「类型」是按实例绑定的:已打开的 PowerShell 终端不会因为你改了 defaultProfile 就自动变成 Git Bash。这是最常被忽略的机制点。

务必执行:

  • 点击终端右上角的垃圾桶图标,关掉所有已打开的终端面板
  • 用 Ctrl + Shift + ` 新建,或通过命令面板运行 Terminal: Create New Terminal
  • 不要点已有终端右上角的「+」按钮——那是 Create New Terminal (Reuse Current Profile),不是新建默认终端

如果正在 WSL 或 SSH 远程环境中,.windows 后缀的配置完全不生效,得配 terminal.integrated.defaultProfile.linux 或 terminal.integrated.defaultProfile.ssh。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

7519

9

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2023.07.06

2080

6

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

2023.07.24

1234

5

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

4877

7

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

4821

6

vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1615

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

3512

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

2149

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1767

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程