VS Code Extension 返回数据如何用 TypeScript 收窄类型
我在扩展里调用接口或读取命令返回的数据时，明明已经声明了类型，为什么在实际处理时还需要再做一次类型收窄？这样做能解决什么问题？
类型收窄可以避免运行时数据不符合预期
在 VS Code Extension 开发中，很多返回数据表面上有类型标注，但实际来源可能来自用户输入、第三方接口、文件内容或 unknown 类型。仅靠静态类型声明并不能保证运行时一定安全。类型收窄的作用，就是在真正使用数据前，确认它是否属于某一种具体类型，从而避免访问不存在的属性、调用错误的方法，或在扩展运行时抛出异常。常见做法包括 typeof、instanceof、in 判断，以及自定义类型守卫函数。通过这些方式，你可以把宽泛类型逐步缩小到可安全处理的具体类型。
有些 VS Code API、命令执行结果或远程调用会返回 `unknown`，我不想直接用类型断言，应该如何编写判断逻辑，才能既安全又方便后续处理？
用类型守卫函数逐层判断返回值
当返回值是 unknown 时，推荐先把它当成不可信数据处理，再用类型守卫来判断。你可以先检查它是不是对象、是否为 null，再继续判断具体字段是否存在，以及字段类型是否正确。比如判断数组可以使用 Array.isArray，判断字符串可以使用 typeof value === 'string'，判断对象属性可以使用 'key' in value。如果结构较复杂，可以封装一个自定义类型守卫函数，例如 function isUser(value: unknown): value is User。这样一来，TypeScript 会在条件分支中自动把类型缩小为 User，后续代码就能获得完整的类型提示和安全性。
我拿到的数据可能是多种结构之一，比如字符串、对象、数组，或者几个不同接口模型的联合类型。为了在扩展里正确处理每一种情况，应该用什么方式来区分？
通过判别字段和条件分支区分联合类型
处理联合类型时，最常见的方式是使用“判别字段”来做类型区分。也就是在每一种数据结构里加入一个固定字段，例如 type、kind 或 status，然后根据这个字段的值进入不同分支。TypeScript 会基于这种判别自动完成类型收窄。若数据本身没有判别字段，也可以结合 typeof、Array.isArray、in 操作符来缩小范围。对于扩展场景，建议把不同数据分支拆成独立函数处理，这样不仅代码更清晰，也能减少错误分支访问字段的风险。
在扩展开发里，为了少写判断，我有时会想直接把结果强转成目标类型。这样虽然代码更短，但会不会带来隐患？类型收窄相比类型断言有哪些实际好处？
类型收窄比强制断言更可靠
类型断言只是告诉编译器“请按这个类型理解”，它不会在运行时验证数据是否真的符合该类型。如果数据格式不对，程序仍然可能在运行时出错。类型收窄则不同，它会通过实际条件检查来证明当前值的类型，从而让 TypeScript 和运行时都更安全。对于 VS Code Extension 来说，扩展经常要处理不稳定输入，例如配置项、外部服务响应、用户选区内容等，这些数据都可能出现意外情况。类型收窄虽然多写几行判断，但能显著降低线上报错概率，也更利于后期维护。