用途:用于处理错误遥测面板中带堆栈跟踪的未处理错误问题,指导如何排查并正确修复,而不是掩盖错误。
主要能力:提供一套从堆栈跟踪定位根因的方法,并说明何时该修源头、何时该补充诊断信息。
使用方式:
- 不要在崩溃点修复。在报错行加类型守卫、用 try/catch 吞掉错误或返回兜底值,只会掩盖问题,非法数据仍会流向别处引发故障。
- 沿调用栈自下而上逐帧追踪数据流,弄清每帧传入和期望的数据、数据来源(IPC 消息、扩展 API 调用、存储、用户输入等),以及数据是否可能在此处被破坏。目标是找到非法数据的产生者,而非崩溃的消费者。
- 若仅凭堆栈无法识别产生者(例如只显示接收侧的 IPC 处理器),在消费端为错误消息补充诊断上下文:非法数据的类型、截断后的值、接收该数据的操作或命令。这些信息会经未处理错误管道自动进入错误遥测面板。不要静默吞掉错误,应让它继续抛出以便在下一轮遥测中暴露发送方;也可在抛出异常的底层校验函数中补充同样的信息。
- 若能识别产生者,直接修复源头:在通过 IPC 发送、存储或传给 API 前校验或清洗数据;确保序列化与反序列化保持类型正确,例如 URI 对象应序列化为 UriComponents 对象而非字符串。
修复前应先阅读构造错误的代码:搜索错误类名或错误消息中的唯一片段,以了解触发条件、错误分类、参数含义以及是否可操作。构造代码是判断修复策略的依据,不要仅凭错误消息臆断。以 ListenerLeakError 为例,构造代码按 topCount 与 listenerCount 的比例区分 dominated(占比大于 30%,即某条代码路径占多数监听器,应修复其释放逻辑)与 popular(占比不超过 30%,堆栈中识别出的路径并非根因,应排查 emitter 及其聚合订阅者,不要删掉顶部的缓存、池化或复用模式)。
适用场景:VS Code 及其扩展相关代码库中,排查和修复来自错误遥测的未处理错误。
限制与注意事项:优先补充错误消息而非加 try/catch 守卫;错误消息中的用户可控值需截断,以避免 PII 并控制长度;不要改动共享工具函数(如 URI.revive)而影响所有调用方,应在具体调用点或产生者处修复;修改后运行相关单元测试,并在宣布完成前通过构建任务检查编译错误。
该技能未提供安装命令、收费方式或平台支持的明确信息,暂未提供。