VSCode插件中捕获未处理Promise拒绝错误的有效方式只有两种：在activate中监听window.unhandledrejection事件，或对所有async命令统一加顶层try/catch；禁用process.on；错误提示需结构化降级，日志须写入OutputChannel而非Terminal。
VSCode插件中如何捕获未处理的 Promise 拒绝错误
插件运行时出现 Uncaught (in promise) Error: xxx 却没进 catch，说明 Promise 被抛出后完全未被监听——这在 VSCode 插件里极常见，且默认不会触发 process.on('unhandledRejection')（Node.js 层被 Electron 封装隔离）。
真正有效的兜底方式只有两个：
- 在插件激活入口（
activate）中显式监听：window.addEventListener('unhandledrejection', e => { handleError(e.reason); e.preventDefault(); }) - 对所有异步命令调用统一包装，例如用
vscode.commands.registerCommand返回的函数必须是async且带顶层try/catch，不能只在内部某一层await后加catch - 避免依赖
process.on：Electron 主进程和渲染进程的 Node.js 环境不一致，process事件在插件沙箱中不可靠
为什么 vscode.window.showErrorMessage 不显示原始堆栈，又该不该显示
直接传 error.stack 给 vscode.window.showErrorMessage 是错的——它会截断、换行混乱，且暴露绝对路径、变量名等敏感信息。用户不需要看到 /home/user/project/src/extension.ts:42:18。
应该做的是结构化降级：
- 对已知错误类型（如
TypeError、URLError）提供固定提示文案，附带可操作建议（“请检查配置中的apiUrl是否可达”） - 对未知错误，只取
error.message前 80 字 + “（详情见输出面板）”，绝不拼接stack - 所有错误都必须写入
vscode.window.createOutputChannel('MyExtension')，并用channel.appendLine(`[${new Date().toISOString()}] ${error.message}`)记录完整上下文
problemMatcher 能否匹配插件控制台的报错输出
不能。problemMatcher 只作用于 tasks.json 定义的构建/运行任务，对插件代码里 console.error() 或未捕获异常的终端输出完全无效。
想让插件运行时报错也进问题面板，唯一办法是把插件启动过程包装成一个 task：
- 在
tasks.json中定义一个type: "shell"任务，command调用npm run extension:debug或直接node ./out/extension.js - 配
"problemMatcher": ["$tsc"]或自定义正则，匹配你插件自己console.error("ERR: xxx")的格式 - 注意：这仅适用于开发调试阶段；生产发布版插件无法被 tasks.json 启动，所以该方案不具备通用性
日志通道（OutputChannel）和终端（Terminal）混用时的常见陷阱
很多插件同时往 OutputChannel 写日志、又用 vscode.terminal.createTerminal() 启动子进程，结果发现错误消息“消失”了——根本原因是两者输出流不互通，且终端关闭后历史记录即丢失。
关键约束必须记住：
-
OutputChannel是持久、可搜索、可导出的，适合记录所有错误和状态变更；务必在插件激活时就创建，不要按需新建 -
Terminal只适合需要用户交互或长时运行的子进程（如本地服务器），它的onDidWriteData事件无法可靠捕获全部输出，尤其遇到二进制或 ANSI 转义序列时会乱码 - 不要试图用
terminal.sendText()触发错误——它只是模拟键盘输入，不是执行环境，不会产生真实异常
最易被忽略的一点：插件里所有异步错误最终都要落到同一个 handleError 函数里，这个函数必须同时做三件事——用户提示、日志落盘、指标上报（比如计数器+1）。漏掉任意一环，都会导致线上问题“看不见、查不到、复现不了”。
