TypeScript 类型思维:从 any 到 unknown

TypeScript 的价值不在于「多写类型」,而在于把运行时的假设提前到编译期验证。

any 是最容易的退路

any 会关闭该值及其后续所有的类型检查,问题会在运行时才暴露。

function parse(input: any) {
  return input.data.items.map((item: any) => item.name)
}

这段代码能通过编译,但任何字段变更都不会被发现。

unknown 是更安全的入口

unknown 表示「暂时不知道类型」,使用前必须收窄。

function parse(input: unknown) {
  if (typeof input !== 'object' || input === null) {
    throw new Error('输入格式错误')
  }
  const data = input as { data?: { items?: Array<{ name: string }> } }
  return data.data?.items?.map((item) => item.name) ?? []
}

类型收窄

通过运行时判断让类型逐步精确,这是 TypeScript 最实用的能力之一。

type Result = { ok: true; data: string } | { ok: false; error: string }

function unwrap(result: Result) {
  if (result.ok) return result.data
  throw new Error(result.error)
}

常见的收窄方式:

  • typeof、instanceof
  • 判别联合(discriminated union)的 ok / type 字段
  • 自定义类型守卫 value is T
  • in 操作符判断属性是否存在

泛型:把类型当参数

泛型让函数在保持类型关系的同时复用逻辑。

function first<T>(list: T[]): T | undefined {
  return list[0]
}

function pick<T, K extends keyof T>(source: T, keys: K[]): Pick<T, K> {
  const result = {} as Pick<T, K>
  keys.forEach((key) => {
    result[key] = source[key]
  })
  return result
}

常用工具类型

类型 作用
Partial<T> 所有属性变为可选
Required<T> 所有属性变为必填
Pick<T, K> 选取部分属性
Omit<T, K> 排除部分属性
Record<K, V> 构造键值映射
ReturnType<F> 获取函数返回类型

实践建议

  1. 新代码避免 any,不确定时先用 unknown
  2. 为接口响应、组件 props、事件参数定义明确类型
  3. 用判别联合表达状态,而不是一堆可选字段
  4. 类型错误优先修类型,而不是用 as 强行绕过
  5. 开启 strict,让编译器替你做代码审查