JavaScript / TypeScript / 系统课时

any 与 unknown

any 与 unknown

本课解决“暂时不知道数据类型时该写什么”的问题。你将看到 any 为什么会关闭类型检查,unknown 如何强制先缩小类型,并掌握处理外部数据的更安全方式。

学习目标

  • 区分 any 与 unknown 的检查行为
  • 使用类型缩小安全处理未知值
  • 在迁移旧代码和接收外部数据时做出合理选择

any 会跳过检查

any 允许几乎所有赋值、属性访问和函数调用。它能快速绕过错误,但也会把风险推迟到运行时。

ts
let value: any = "TypeScript";
console.log(value.toUpperCase());

value = 10;
console.log(value.toUpperCase());

预期结果

text
第一行输出 TYPESCRIPT,随后运行时报错,因为数字没有 toUpperCase 方法。

编译器不会阻止第二次调用,因为 any 相当于关闭了这条数据链上的大部分类型检查。

unknown 要求先判断

unknown 可以接收任意值,但不能直接访问属性或调用方法。使用前必须通过 typeof、instanceof 或自定义类型守卫缩小范围。

ts
function normalize(value: unknown): string {
  if (typeof value === "string") {
    return value.trim();
  }

  if (typeof value === "number") {
    return value.toFixed(2);
  }

  return "不支持的类型";
}

console.log(normalize("  TypeScript  "));
console.log(normalize(12));
console.log(normalize(true));

预期输出

text
TypeScript
12.00
不支持的类型

类型判断通过后,编译器才允许使用对应类型的方法,这能迫使代码显式处理不同输入。

处理未知对象

外部接口返回的数据应先当作未知值,再验证结构:

ts
type Course = {
  id: number;
  title: string;
};

function isCourse(value: unknown): value is Course {
  if (typeof value !== "object" || value === null) return false;

  const record = value as Record;
  return typeof record.id === "number" && typeof record.title === "string";
}

const response: unknown = { id: 1, title: "TypeScript 教程" };

if (isCourse(response)) {
  console.log(response.title);
}

预期输出

text
TypeScript 教程

这里的类型断言只用于检查对象字段,真正决定能否作为 Course 使用的是后续运行时判断。

如何选择

接收不可信数据、捕获异常值或设计通用函数时,优先使用 unknown。维护旧 JavaScript、第三方库缺少类型或短期迁移时,可能暂时使用 any,但应限制范围并尽快收紧。

对比项 any unknown
可接收任意值 是 是
可直接访问属性 是 否
会保留类型检查 基本不会 会
推荐场景 临时兼容 未知外部数据
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

any 与 unknown

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通