应先执行code --disable-extensions进入安全模式确认F5是否恢复,若正常则问题100%出在扩展层;再禁用全部扩展后逐组启用并观察exthost日志,重点排查rust-analyzer、augment等近期更新的语言服务器或AI补全插件。

调试器进程被意外终止(exthost崩溃)
VSCode弹出“扩展宿主意外终止”后F5就失效,本质是某个插件在调试启动阶段把exthost进程搞崩了,不是你的代码或launch.json写错了。安全模式下F5能用,就100%锁定在扩展层。
分三步快速定位:
- 先执行
code --disable-extensions启动,确认F5是否恢复正常;如果仍中断,问题在VSCode本体、系统环境或用户配置(比如settings.json里写了非法JSON) - 若安全模式OK,打开命令面板运行
Extensions: Disable All Installed Extensions,重启后再逐组启用——重点盯住最近更新过的语言服务器(如rust-analyzer)、AI补全(如augment)、SFTP类插件 - 查
exthost1.log(路径:%APPDATA%Codelogs\exthost1.log或~/Library/Application Support/Code/logs//exthost1.log),搜索Extension host terminated unexpectedly,往上翻看最后一行调用栈,常见线索如at augment.*.js:123:45或Failed to load module 'vscode'
launch.json配置错导致“Cannot find program”或卡住
F5点下去没反应、报错说找不到程序,大概率是launch.json里program字段路径不对,或者根本没配对调试器。VSCode的F5不读你当前文件名,它只认launch.json里写的路径和type值。
关键检查点:
-
program别写死绝对路径(如"C:\project\main.py"),换成"${file}"(当前文件)或"${workspaceFolder}/src/index.js"(工作区相对路径) - 确保
type和已安装的调试扩展匹配:Python项目必须装ms-python.python,Node.js项目要ms-vscode.node-debug或新版ms-vscode.js-debug,C/C++得有ms-vscode.cpptools - Node.js项目用了ESM(
"type": "module"),launch.json里得加"runtimeArgs": ["--experimental-specifier-resolution=node"],否则直接退出 - Java项目没生成
.class文件?检查preLaunchTask是否指向了正确的构建任务,且该任务实际能成功执行
远程调试(SSH/WSL)反复提示“Cannot reconnect, please reload the window”
这个提示不是网络断了,而是VSCode前端和远程vscode-server进程之间的WebSocket信令通道死了。reload窗口只重启前端,不拉起后端服务,所以治标不治本。
必须进远程机器查真实状态:
- 登录服务器,执行
ps aux | grep -i 'vscode-server',确认node进程还在跑;如果没了,说明上次部署失败(常见于磁盘满、glibc版本太低、缺少tar) - 进程存在但无响应?进
~/.vscode-server/bin/<commit-id>/bin/</commit-id>目录,运行./code-server --status,超时或报错即证明服务僵死 - 别手贱删整个
.vscode-server目录——先备份,再用命令面板执行Remote-SSH: Kill VS Code Server on Host,让VSCode重连时自动重部署 - SSH保活配置必须两端生效:
~/.ssh/config里加ServerAliveInterval 60,远程/etc/ssh/sshd_config里开ClientAliveInterval,光设remote.SSH.keepAlive没用
断点不触发或跳过,实际是源码与运行时脱节
断点灰了、点了没反应、或者执行到别处去了,90%不是VSCode坏了,而是调试器找不到对应代码位置。核心矛盾在于:你编辑的是源码,但调试器 attach 的是编译/打包后的产物。
典型场景和解法:
- Web项目用Webpack/Babel,没开source map?
devtool: 'source-map'必须写在webpack.config.js里,否则断点映射完全失效 - Java项目没编译?确认
build任务已成功运行,launch.json里program指向的是.class文件而非.java源文件 - Node.js没启调试模式?命令行启动得带
--inspect参数,否则V8根本不暴露调试接口,所有断点都被忽略 - 多线程/协程里断点不进?比如Go的goroutine或Python的async def,主线程早结束了,得在阻塞点(如
fmt.Scanln()或input())挂住,再等子任务调度


















