TypeScript 语法速查表 - TypeScript 类型与泛型编程大全
这套速查给想把“写清楚类型”落实进日常代码的 JS/前端开发者。与只贴一堆类型定义的片段不同，这里按“变量→接口→泛型→工具类型”递进组织，每一条都会解释它在什么场景解决什么问题，比如什么时候用 interface 而不是 type、怎么用 Partial 把表单字段变可选、Pick/Omit 如何快速从大类型里挑子集。读完你应能给出函数和对象的准确类型，用联合字面量限定取值，并借助工具类型做类型体操来缩小可选项。
基础类型 8
let name: string = "John"let age: number = 30let isActive: boolean = truelet items: string[] = ["a", "b"]let tuple: [string, number] = ["a", 1]let value: any = "anything"let value: unknown = "safe"let value: never接口与类型 5
interface User { name: string; age: number }type User = { name: string; age: number }interface Admin extends User { role: string }type Status = "active" | "inactive"type Result = string | null | undefined泛型 4
function identity<T>(arg: T): T { return arg }interface Container<T> { value: T }type Pair<T, U> = [T, U]function getFirst<T>(arr: T[]): T工具类型 6
Partial<User>Required<User>Readonly<User>Pick<User, "name" | "age">Omit<User, "age">Record<string, number>提示
- unknown 比 any 更安全，使用前必须做类型检查或类型断言。
- interface 可以声明合并，type 不能；type 支持联合类型和映射类型。
- as const 可以让对象属性变成字面量类型，如 { role: "admin" as const }。
- satisfies 运算符（TS 4.9+）可以验证类型同时保留推断类型。
常见问题
typescript 的 interface 和 type 该怎么选?
大部分场景二者可互换，type 还能表示联合、元组、映射等 interface 表达不了的类型。若对象需要被扩展、实现或对外暴露，官方倾向用 interface（支持声明合并）；做联合、交叉、条件类型等类型体操时用 type。同一代码库内保持风格一致即可。
typescript 的 any 和 unknown 有什么区别?
any 会关闭类型检查，可赋给任何类型也能被任意读写，等于绕过类型系统；unknown 表示还不知是什么，只能接收赋值，使用前必须做类型收窄（typeof、instanceof 或断言）。想让代码更安全，就尽量用 unknown 替代 any。
泛型约束 extends 有什么用?
泛型约束用 extends 限定传入类型必须具备某些结构，例如 <T extends {length: number}> 保证 T 有 length 属性，函数内就能安全调用 t.length 而不报错。约束可以组合，并且返回类型仍保留具体泛型的推导结果。
Partial、Pick、Omit 这几个工具类型怎么区分?
Partial<T> 把 T 的所有属性变成可选，常用于表单提交前部分字段已填的场景；Pick<T, K> 从 T 中挑出指定键 K 组成新类型；Omit<T, K> 相反，剔除键 K 保留其余。三者都只是编译期类型，不会改变运行时的对象结构。
类型断言 value as T 什么时候用?
as 断言是告诉编译器我知道这是什么类型，应在确实比编译器更清楚时使用，比如把从 any 或 JSON 解析来的数据收窄。滥用断言会隐藏真 bug；优先写可被推断的类型或先做运行时校验（如 hasOwnProperty）再断言。非空断言 expr! 只是去掉 null/undefined，若实际为空会在运行时报错。
由 巧匠 维护
公开更新于 2026年7月21日，内容持续校对官方文档。