VSCode集成终端启动失败的根本原因是找不到可用shell可执行文件或路径配置错误。常见于Windows，表现为“Failed to launch terminal process”，需检查settings.json中terminal.integrated.defaultProfile.windows路径是否正确、杀软拦截、PATHEXT环境变量异常，并通过开发者工具查看具体错误日志。
终端进程已终止，显示“Failed to launch terminal process”
这是 vscode 集成终端最典型的启动失败现象，通常出现在 windows 上，根本原因是 vscode 找不到可用的 shell 可执行文件，或路径配置错误。它不一定是 powershell 或 cmd 崩溃，而是 vscode 根本没成功 spawn 出子进程。
-
settings.json中的terminal.integrated.defaultProfile.windows如果指向了已卸载或重命名的 shell（比如旧版 Git Bash 的git-bash.exe路径失效），就会静默失败 - Windows Defender 或第三方杀软可能拦截
conhost.exe或 shell 启动过程，表现为无报错、终端窗口一闪而逝 - 用户环境变量
PATHEXT被意外清空时，VSCode 无法识别.exe后缀，导致cmd或powershell查找失败
如何手动指定一个可靠 shell 路径
绕过自动探测，强制使用已知有效的 shell 是最快恢复方式。重点不是“选哪个”，而是“路径必须绝对且可执行”。
- PowerShell（推荐）：用系统自带的
pwsh.exe（PowerShell Core）或powershell.exe（Windows PowerShell），路径示例：C:\Program Files\PowerShell\7\pwsh.exe - Windows Terminal 兼容方案：如果装了 Windows Terminal，它的
wt.exe本身不能直接当终端 shell 用，但可以配合--startingDirectory参数启动，不过 VSCode 不支持该参数，所以不建议设为 profile - Git Bash 注意路径：新版 Git for Windows 默认安装在
C:\Program Files\Git\bin\bash.exe，而非旧版的git-bash.exe；若使用bash.exe，需确保其父目录bin在系统PATH中，否则 VSCode 会报“command not found”
{
"terminal.integrated.defaultProfile.windows": "PowerShell",
"terminal.integrated.profiles.windows": {
"PowerShell": {
"source": "PowerShell",
"icon": "terminal-powershell"
},
"Command Prompt": {
"path": "cmd.exe"
},
"Git Bash": {
"path": "C:\Program Files\Git\bin\bash.exe"
}
}
}
检查 shell 是否被策略或权限阻止
即使路径正确，终端仍空白或闪退，大概率是执行被拦截。这不是 VSCode 的 bug，而是 Windows 系统层限制。
- 以管理员身份运行 VSCode，测试是否能启动终端——若可以，说明当前用户权限不足，或组策略禁用了交互式 shell 启动
- 临时关闭 Windows Defender 实时保护，再重启 VSCode 测试；如恢复，则需在 Defender 设置中将
code.exe和对应 shell（如pwsh.exe）加入排除项 - 检查组策略：运行
gpedit.msc→ 计算机配置 → 管理模板 → 系统 → “防止访问命令提示符”，确认该项为“未配置”或“已禁用”
重置终端配置与缓存
VSCode 的终端状态有时会卡在损坏的 session 中，单纯改设置无效，必须清除上下文。
- 关闭所有 VSCode 窗口，删除
%USERPROFILE%\AppData\Roaming\Code\Cache\terminal目录（如果存在） - 在 VSCode 中按
Ctrl+Shift+P，输入并执行Terminal: Kill All Terminals，再执行Developer: Reload Window - 禁用所有插件后重启，逐个启用排查——尤其注意终端增强类插件（如
shell-launcher、terminal-tabs），它们可能劫持createTerminalAPI 导致冲突
真正麻烦的不是找不到 shell，而是 VSCode 把失败日志藏得很深：打开开发者工具（Help → Toggle Developer Tools），切到 Console 标签页，搜索 terminal 或 spawn，往往能看到具体哪一步 ENOENT 或 EACCES。
