vscode 终端默认启动 git bash 需在 settings.json 中配置 "terminal.integrated.defaultprofile.windows": "git bash" 和 "terminal.integrated.profiles.windows": { "git bash": { "path": "c:\\program files\\git\\git-bash.exe" } },路径必须指向 git-bash.exe 且与 profile 名严格一致,重启后生效。

怎么让 VSCode 终端默认启动 Git Bash
VSCode 默认在 Windows 上用 PowerShell,但写前端、用 Git 或跑 Shell 脚本时,Git Bash 更顺手。改默认终端本质是告诉 VSCode:“下次点 + 新建终端时,优先起这个程序”。关键不在“安装”或“检测”,而在准确配置 terminal.integrated.defaultProfile.windows 这个设置项。
必须确认 Git Bash 的真实可执行路径
很多人填错路径导致配置无效——VSCode 不会自动猜你装在哪,也不会从环境变量里拉 bash.exe。它要的是完整、带引号的绝对路径,且必须指向 git-bash.exe(不是 bash.exe),否则终端能打开但缺 Git、SSH 等命令。
- 典型正确路径:
"C:\Program Files\Git\git-bash.exe"(注意双反斜杠或用正斜杠) - 如果装在其他位置(比如用户目录下),用文件资源管理器右键 → “属性” → 复制“目标”栏内容,删掉末尾的
--cd-to-home - 别用
C:Program FilesGitinash.exe:它没加载 Git 的环境,git命令会报'git' is not recognized
在 settings.json 里硬编码配置最稳
用图形界面点选有时会失败(尤其多版本共存或路径含空格时),直接改 JSON 文件反而可靠。VSCode 的终端 profile 配置依赖底层识别逻辑,GUI 选项可能漏掉关键字段。
- 按
Ctrl + Shift + P→ 输入Preferences: Open Settings (JSON)回车 - 在
{}内添加这段(注意逗号分隔):"terminal.integrated.defaultProfile.windows": "Git Bash",
- 再加一条 profiles 定义(否则 VSCode 可能不认这个名字):
"terminal.integrated.profiles.windows": { "Git Bash": { "path": "C:\Program Files\Git\git-bash.exe" } } - 重启 VSCode:改完不重启,旧终端实例不会生效
为什么改了还是弹 PowerShell?常见断点排查
配置看似对了却无效,大概率卡在三个地方:路径拼错、profile 名不一致、或者被工作区设置覆盖。
-
terminal.integrated.defaultProfile.windows的值(比如"Git Bash")必须和profiles.windows里定义的 key 完全一致,大小写、空格都不能差 - 检查有没有
.vscode/settings.json在当前项目根目录下——它会覆盖全局设置,删掉或同步修改那里的defaultProfile - 如果用的是 Windows Terminal 集成,确保没勾选
terminal.integrated.automationShell.windows这类实验性选项,它会干扰默认行为 - 终端右上角下拉菜单里看不到 “Git Bash”?说明
profiles配置没生效,先检查 JSON 语法是否合法(逗号、引号、括号)











