TypeScript unknown 和 any 有什么区别？怎么安全处理未知类型？

Question

仓乃文 · Accepted Answer

any 关闭了类型检查，任何操作都不报错但运行时可能崩溃。unknown 是类型安全的顶层类型，接收任何值但使用前必须收窄类型，强制开发者处理未知数据，避免运行时错误。

any 的危险：
```typescript
const data: any = JSON.parse(raw);
data.foo.bar.baz;  // 编译不报错，运行时崩溃
```

unknown 的安全：
```typescript
const data: unknown = JSON.parse(raw);
data.foo;  // 报错：Object is of type "unknown"

// 必须先收窄类型
if (typeof data === "object" && data !== null && "foo" in data) {
  console.log(data.foo);  // OK
}
```

封装安全的 JSON 解析：
```typescript
function safeParse<T>(raw: string, guard: (v: unknown) => v is T): T | null {
  try {
    const data: unknown = JSON.parse(raw);
    return guard(data) ? data : null;
  } catch {
    return null;
  }
}
```

补充说明：
- unknown 是 any 的安全替代品，TS 3.0+ 引入
- unknown 类型的值不能直接赋值给其他类型（除了 any 和 unknown）
- 使用 unknown 前必须通过 typeof、instanceof 或自定义守卫收窄
- 第三方库返回 unknown 时比 any 更安全
- API 响应建议用 unknown 接收再校验，而非 any 或直接断言