JavaScript / TypeScript / 知识点

TypeScript 速查手册

手册条目

识别和减少 any 带来的类型风险。

处理 any 类型

any 会关闭当前值及其传播链上的类型检查。处理重点不是一次性清零,而是先找到输入边界,再把 any 收紧为具体类型、泛型或 unknown,让错误重新回到编译期。

什么时候需要处理

看到显式 any、未标注参数产生的隐式 any、第三方库缺少类型声明,或一个 any 继续污染多个变量时,应优先处理。先修复外部输入、接口响应和公共函数返回值,因为这些位置最容易扩大影响范围。

识别与收紧

开启 strict 和 noImplicitAny 可拦截隐式 any,但显式 any 仍会通过编译。已知结构使用接口或类型别名;类型由调用方决定时使用泛型;来源不可信时改用 unknown 并执行类型收窄;第三方模块无类型时则补充声明文件或封装适配层。

主示例

下面保留一个不安全函数用于对比,并用 unknown 加类型守卫阻断错误数据。

ts
type User = {
  name: string;
};

function unsafeUpperName(value: any): string {
  return value.name.toUpperCase();
}

function isUser(value: unknown): value is User {
  if (typeof value !== "object" || value === null) return false;
  return typeof (value as Record<string, unknown>).name === "string";
}

function safeUpperName(value: unknown): string {
  if (!isUser(value)) return "INVALID_USER";
  return value.name.toUpperCase();
}

console.log(unsafeUpperName({ name: "Ada" }));
console.log(safeUpperName({ name: "Lin" }));
console.log(safeUpperName({ name: 123 }));

运行命令:

bash
npx tsc any-demo.ts --strict --target ES2020 --module commonjs && node any-demo.js

预期输出:

text
ADA
LIN
INVALID_USER

前两行是合法对象的转换结果,第三行说明错误结构已被守卫拦截。若把最后一次调用改成 unsafeUpperName({ name: 123 }),编译仍会通过,但运行时会因数字没有 toUpperCase 方法而抛出异常。

风险与边界

把 any 直接断言成目标类型只会绕过检查,不会验证运行时数据。输入结构与断言不一致时,可能产生线上 TypeError、错误计算或脏数据传播。安全替代方案是先接收为 unknown,再通过类型守卫、解析函数或模式校验库确认结构。

第三方库暂时只能返回 any 时,应将其限制在单一适配层中。适配层负责校验并返回具体类型,不要让 any 暴露到业务函数参数、公共返回值或共享状态中。

排障清单

  • 搜索 : any、as any、Array<any> 以及返回值为 any 的公共函数。
  • 检查 any 是否进入对象、数组、Promise 或回调参数并继续传播。
  • 开启 strict 和 noImplicitAny,重新编译以暴露隐式问题。
  • 对暂时无法移除的 any 标注来源和边界,并优先封装而不是继续扩散。

目录与阅读设置

记录一个想法

TypeScript 速查手册

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

登录哪都通