如何在VSCode插件调试过程中捕获全局未处理异常

酷静大大_9685

酷静大大_9685

2026-09-05

296人浏览

原创

vscode插件调试时收不到uncaughtexception是因为extension host调试器默认拦截未捕获异常,不触发process全局钩子;必须在extension.ts顶部同步调用sentry.init()并配置onuncaughtexception、onunhandledrejection集成,且launch.json中console设为integratedterminal。

如何在vscode插件调试过程中捕获全局未处理异常

VSCode插件调试时为什么收不到 uncaughtException

因为 VSCode 的 Extension Host 调试器默认不把未捕获异常透传给 Node.js 全局钩子,process.on('uncaughtException') 和 process.on('unhandledRejection') 在插件进程里形同虚设——不是你没写,而是调试环境主动拦截并吞掉了。

必须在 extension.ts 最顶部同步调用 Sentry.init()

哪怕只差一行,就可能漏掉入口文件里 require 或 import 引发的同步崩溃。常见错误包括:

  • Sentry.init() 写在 activate() 函数里——此时插件已开始注册命令、监听事件,早期异常早已发生
  • 先 import * as vscode from 'vscode',再初始化 Sentry——但某些插件依赖的模块(如 vscode-languageclient)内部可能含同步报错
  • 没显式传 integrations,尤其在旧版 SDK(v6.x)中,OnUncaughtException 和 OnUnhandledRejection 默认关闭

正确写法(紧贴文件开头):

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
import * as Sentry from '@sentry/node';
<p>Sentry.init({
dsn: '<a href="https://www.php.cn/link/68624a8a1f8dd04e260c0173bad7ee31">https://www.php.cn/link/68624a8a1f8dd04e260c0173bad7ee31</a>',
integrations: [
new Sentry.Integrations.OnUncaughtException(),
new Sentry.Integrations.OnUnhandledRejection(),
],
// 确保不被插件市场或用户环境过滤
denyUrls: [/^file:\/\//, /^chrome:\/\//],
});
</p>

launch.json 的 console 必须设为 integratedTerminal

这是最常被忽略的配置项。若 console 是 externalTerminal 或 internalConsole,Sentry 的异常上报逻辑会因标准输出重定向失败而静默丢弃。

  • console: "integratedTerminal" 才能保证 process.stderr.write 正常触发,Sentry 才有机会序列化并发送事件
  • 同时确认 env 中透传了必要变量,比如某些 SDK 需要 NODE_OPTIONS: "--trace-warnings" 来暴露隐式拒绝
  • 别信 exceptions 字段:VSCode Node 调试器完全忽略 launch.json 里的 "exceptions": { "uncaught": true },它只响应 UI 断点面板里的开关

Promise 拒绝必须手动启用 Uncaught Promise Rejections 断点

插件里大量异步操作(如 vscode.workspace.findFiles()、fetch() 封装)一旦没加 .catch() 或 try/catch await,就会触发 unhandledRejection——但 VSCode 默认不中断,也不上报 Sentry,除非你肉眼盯住「运行和调试」侧边栏的断点区域:

  • 点击「断点」区域右上角的 + 号 → 选择 Node.js: Uncaught Promise Rejections
  • 确保该条目是实心勾选状态(灰色空心 = 未启用)
  • 这个开关和 Uncaught Exceptions 是两个独立开关,少一个,Promise 崩溃就无声无息
  • F5 启动调试才生效;终端里直接 node ./extension.js 不走这套机制

真正难调试的,永远不是你看见的报错,而是那些连堆栈都没留下、进程直接退出的瞬间——它们往往发生在插件加载初期,且只在用户机器上复现。盯住 integratedTerminal 输出和 Sentry 的 denyUrls 配置,比加一百个 console.log 更管用。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1255

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2612

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1889

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1707

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2587

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1798

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1242

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1096

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

454

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程