终端默认profile没生效需先确认作用域:仅terminal.integrated.defaultprofile.windows在windows生效,工作区设置会覆盖用户设置;git bash未显示需手动注册path和args;powershell版本名须与select default profile列表完全一致;改配置后需关闭所有终端再新建才生效。

终端默认 profile 没生效?先确认设置作用域
VSCode 终端默认行为被 terminal.integrated.defaultProfile.windows 控制,但它只在 Windows 平台生效——写成 terminal.integrated.defaultProfile 或漏掉 .windows 后缀,配置完全无效。更常见的是:你改了用户级设置,但当前工作区(.vscode/settings.json)里有同名字段,它会直接覆盖用户设置。
检查方法:按 Ctrl + , 打开设置 → 搜索 terminal integrated default profile → 看右侧显示“已设置于 用户”还是“已设置于 工作区”。若显示后者,删掉工作区文件里的那一行再试。
Git Bash 不出现在下拉列表?手动注册路径是关键
VSCode 不会递归扫描整个磁盘找 git-bash.exe,它只查注册表和几个固定路径(如 C:Program FilesGit)。如果 Git 安装在非标位置(比如 C:ToolsGit),或你用的是便携版,下拉菜单里必然没有 Git Bash。
此时必须手动定义 profile:
-
git-bash.exe是正确入口(不是bash.exe或sh.exe),否则 Windows 路径映射(如c:/xxx)不工作,cd c:/project会报错 - 路径中反斜杠要双写:
"C:\Tools\Git\git-bash.exe",单斜杠或没转义会导致 JSON 解析失败 - 加
"args": ["--login"]才能加载~/.bashrc,否则环境变量、别名全失效
完整示例(粘贴进 settings.json):
监控一个或多个 GitCode 仓库的 PR,通过 OpenClaw Gateway 自动执行 AI 审查,发布 PR 评论,并发送钉钉和企业微信通知。
{
"terminal.integrated.profiles.windows": {
"Git Bash": {
"path": "C:\Tools\Git\git-bash.exe",
"args": ["--login"]
}
},
"terminal.integrated.defaultProfile.windows": "Git Bash"
}
PowerShell 启动后命令报错?注意版本名匹配
VSCode 下拉菜单里显示的名称,就是 terminal.integrated.defaultProfile.windows 的合法取值——不能靠猜。常见陷阱:
- 系统自带 PowerShell 5.1 → 值为
"PowerShell" - 手动安装 PowerShell 7+(
pwsh.exe)→ 值通常是"PowerShell (pwsh)",括号和空格一个都不能少 - 若装了 GitHub Desktop 自带的 PowerShell,名字可能是
"PowerShell (GitHub Desktop)"
验证方式:按 Ctrl + Shift + P → 输入 Terminal: Select Default Profile → 看弹出列表里实际显示什么,就填什么。
改完设置终端还是旧的?别忽略终端复用机制
VSCode 默认重用已有终端实例。你改了默认 profile,但已打开的 PowerShell 标签页不会自动切换;关掉所有终端再按 Ctrl + ` 新建,才真正走新配置。
另外,某些企业策略(GPO)会禁用 wsl.exe 或 git-bash.exe,此时终端可能静默失败(空白窗口、一闪而退)。先在 Windows Terminal 里手动运行一遍你的目标路径,确认可执行文件本身能启动,再回头排查 VSCode 配置。
最常被跳过的动作:改完 settings.json 后没保存,或保存时编辑器自动格式化把引号弄成了中文符号——JSON 只认英文双引号。










