vs code 终端配置必须通过 settings.json 修改,f12 无效;git bash 需用完整路径如 "c:\program files\git\bin\bash.exe" 并加 --login;默认不进入当前文件目录,需设 terminal.integrated.cwd 为 "${workspacefolder}" 或绝对路径。

VSCode 本身没有“开发者工具”配置终端这一说法——终端配置在设置系统里,不是靠 F12 开发者工具完成的。 常见误解是把浏览器开发者工具(F12)和 VS Code 的设置/配置混为一谈。VS Code 的终端行为由 settings.json 控制,所有修改都得走这个路径,F12 完全无效。
终端默认 Shell 配置必须改 settings.json
图形界面设置(Ctrl + ,)里搜 terminal.integrated.defaultProfile.windows 只能临时选一次,关掉终端再开就失效;真正生效必须写进 JSON 配置。Windows 下 Git Bash 路径不能只填 bash.exe 或 git-bash.exe,必须用完整绝对路径,且注意:git-bash.exe 启动的是 GUI 窗口,bin/bash.exe 才是纯终端进程。
- 推荐用
bin/bash.exe:路径类似"C:\Program Files\Git\bin\bash.exe",支持--login参数加载.bashrc - 避免用
git-bash.exe:它会额外启动 mintty,VS Code 无法正确捕获退出状态,导致任务中断、Shell 集成失效 - 路径中的反斜杠必须双写(
\),否则 JSON 解析报错Invalid escape character in string
工作目录不配 terminal.integrated.cwd 就永远 cd 不对
很多人以为终端会自动进入当前打开的文件所在目录,其实不会。VS Code 终端默认启动路径是用户主目录($HOME)或上一次关闭时的路径,和编辑器里正在看哪个文件完全无关。必须显式配置 terminal.integrated.cwd 才能保证每次打开都在项目根下。
- 最常用值:
"${workspaceFolder}"—— 仅当以“打开文件夹”方式加载项目时有效 - 单文件打开时无效,此时
${workspaceFolder}为空,终端 fallback 到$HOME - 想强制进某个固定路径,写绝对路径如
"C:\dev\myproject",但跨设备同步时需手动改
终端启动失败常见报错及对应修复
配置完不生效?大概率是下面三个错误之一:
-
Failed to launch terminal: The terminal process failed to launch:路径错或权限不足,检查bash.exe是否被杀毒软件拦截 -
Command not found: git:bin/bash.exe默认不继承 Windows PATH,需在args中加--rcfile指向自定义初始化脚本,或改用cmd/git.exe路径下的bash.exe - 终端一闪而退:缺少
--login参数,导致 shell 读不到.bashrc,立即退出;加到args数组里即可
路径查不准、JSON 写错斜杠、误用 git-bash.exe 而非 bash.exe——这三个点卡住 90% 的人。配置前务必用 where git 定位真实安装位置,然后手工拼出 bin/bash.exe 路径,别抄网上的默认路径。











