unknown 是什么类型?
参考答案
定义
unknown 是 TS 3.0 引入的顶层类型(top type):任何值都可以赋给它,但它不能直接赋值给其他类型,也不能直接使用,必须先做类型收窄(narrowing)。
let u: unknown = JSON.parse(str);
u.toFixed(); // ❌ 报错
if (typeof u === 'number') u.toFixed(2); // ✅ 收窄后可用
const n = u as number; // 断言
与 any 对比
| 维度 | any | unknown |
| --- | --- | --- |
| 赋值给它 | 任何值 | 任何值 |
| 从它赋值出去 | 可以(不检查) | 不可以(除非收窄或断言) |
| 属性访问/调用 | 随意 | 禁止 |
| 类型安全性 | 关闭检查(污染传播) | 保留检查,必须收窄 |
| 适合场景 | 迁移期、确实无法建模 | 外部输入(API、JSON.parse、catch、用户事件) |
使用场景
- API 响应、
JSON.parse结果、localStorage读取 —— 未知结构先标unknown,再用 zod/io-ts 或手写守卫校验成具体类型。 - **
catch (e)**:TS 4.4+ 默认e是unknown(useUnknownInCatchVariables),必须先判断e instanceof Error。 - 函数参数:库的泛型兜底、
Record<string, unknown>表示任意对象值。
收窄方式
typeof、instanceof、in、字面量比较、自定义类型守卫(x is T)、asserts x is T 断言函数、Array.isArray。
一句话
**unknown 是"安全的 any"**:外部数据入口一律用 unknown,用类型守卫收窄后再进入业务逻辑,避免 any 一路污染。