12.3 阶段 2 TypeScript 语言核心
本页目录
一、阶段定位
本阶段解决「给 JavaScript 加上可编译期检查的类型系统」。前端大型项目里,接口字段改名、参数传错、undefined 解引用这类问题如果没有类型约束,全靠人肉与运行时报错兜底。TypeScript 5.x 是当前主流基线,它不是「带类型的 JS」那么简单,理解类型推导、联合与交叉、泛型、类型守卫,直接决定你在阶段 3 写组件 props 时能不能让编译器替你抓错。
不掌握本阶段会在后面具体卡在哪:
- 只会给变量标
string/number,到阶段 3 写组件 props 时不知道怎么描述「可选、联合字面量、事件回调签名」,最后全标any。 - 看不懂库的 d.ts 报错,
node_modules里类型报错一堆,只会// @ts-ignore糊过去。 - 不理解类型拓宽与字面量类型,为什么
let x = 'a'是string而不是'a'。 - 泛型只会抄
<T,>,写一个pick、omit工具类型要查半天。
判断卡住的标志:给你一个对象 { name: string; age?: number },让你写出「接收这个对象、返回只含 name 的新对象」的函数类型,你写不出;或编译器报 Type 'string' is not assignable to type '"a" | "b"',你不知道怎么修。出现任一现象,先把本阶段六个模块过一遍再进 阶段 3 框架与组件化。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能写基础类型、接口、类型别名、字面量联合 | 不用 any 描述一个用户对象与事件回调 |
| 能解释类型推导、拓宽、收窄 | 能说出 let 与 const 推导差异 |
| 能写泛型函数与工具类型 | 手写 Pick<T, K>、Partial<T> |
能用类型守卫与 typeof/instanceof/in 收窄 |
写一个处理联合类型的 switch |
能配置 tsconfig.json 并读懂常见报错 |
工程开启 strict 无 any 报错 |
| 能引入第三方库的类型并声明自己模块类型 | pnpm add -D @types/xxx 能用 |
建议学时:
- 全职:2 周,约 40 小时。JS 异步与原型回顾 6 小时、基础类型与接口 8 小时、联合交叉与收窄 8 小时、泛型与工具类型 10 小时、tsconfig 与工程集成 4 小时、练习 4 小时。
- 在职:4 周,约 45 小时。有后端强类型语言经验的人可压缩语法部分,重点放在类型收窄与泛型。
三、先修自检
| 先修项 | 合格标准 | 不合格时怎么办 |
|---|---|---|
| JavaScript 基础 | 能写变量、函数、数组方法、Promise、async/await | 先用 1 周过 MDN JavaScript 教程 |
| 阶段 0 产出 | 能用 Vite 起 TS 模板 | 回到 12.1 |
| 异步模型 | 能解释事件循环、宏任务微任务 | 模块 5.1 会快速回顾 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| JS 异步 | 事件循环、宏/微任务、Promise、async/await | 能讲清原理 | 03.2 JavaScript |
| 基础类型 | string/number/boolean、数组、元组、枚举、void/never/unknown | 会用 | 03.3 TypeScript |
| 对象类型 | interface、type alias、可选 readonly、索引签名 | 能讲清原理 | 03.3 TypeScript |
| 联合与收窄 | 字面量联合、typeof/instanceof/in、可辨识联合、穷尽检查 |
能讲清原理 | 03.3 TypeScript |
| 泛型 | 泛型函数、泛型约束 extends、常用工具类型 |
能讲清原理 | 03.3 TypeScript |
| 工程集成 | tsconfig、strict、模块解析、@types、 declaration |
会用 | 03.6 前端工程化 |
五、分模块精讲
5.1 JavaScript 异步与事件循环(回顾)
为什么需要它:TS 是 JS 的超集,异步模型不理解,写 await 与 Promise 时顺序问题永远靠猜。
核心机制:
- 事件循环:调用栈空了就清空微任务队列(
Promise.then、queueMicrotask),再取一个宏任务(setTimeout、I/O、UI 事件),循环往复。 async/await是 Promise 的语法糖:await暂停当前 async 函数,让出微任务队列。- 常见坑:
for循环里await是串行;forEach里await不等待(它不返回 Promise)。
最小可运行示例:
console.log('1')
setTimeout(() => console.log('2'), 0)
Promise.resolve().then(() => console.log('3'))
console.log('4')
// 输出顺序:1 4 3 2(微任务 3 先于宏任务 2)
async function fetchUsers() {
const res = await fetch('/api/users')
return res.json()
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 循环里 await 没生效 | forEach 不等待 | 改 for...of 或 Promise.all |
| Promise 报 Uncaught | 没 catch | 加 .catch 或 try/catch |
面试考法:问事件循环与宏微任务顺序。按上面的例子能口头推出顺序即可。
5.2 基础类型与对象类型
为什么需要它:组件 props、接口返回值都要描述清楚,否则阶段 3 全是 any。
核心机制:
- 基本类型:
string、number、boolean、null、undefined、void、never、unknown、any(能不用就不用)。 - 数组:
number[]或Array<number>;元组[string, number]固定长度与类型。 - 对象:
interface User { name: string; age?: number; readonly id: string };type与interface的区别——interface可声明合并、适合对象与类;type可表达联合、交叉、工具类型。 - 字面量类型:
'success' | 'fail'比string精确;as const把字面量冻结。
最小可运行示例:
type Status = 'idle' | 'loading' | 'success' | 'error'
interface User {
readonly id: number
name: string
age?: number
tags: string[]
}
const u: User = { id: 1, name: 'Ann', tags: ['admin'] }
// u.id = 2 // 报错:readonly
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 接口返回多一个字段不报错 | 没开 excess property check 边界 | 给函数参数标精确类型 |
| 变量被推导成宽类型 | let 推导为 string 而非字面量 | 用 as const 或显式标注 |
面试考法:问 type 与 interface 区别。答到:interface 可声明合并、支持 extends/implements;type 更灵活可表达联合交叉。
5.3 联合类型与类型收窄
为什么需要它:前端接口经常返回「成功有数据、失败有错误」的联合,不会收窄就只能 as any。
核心机制:
- 联合类型
A | B:只能访问 A 与 B 共有的成员;要访问特有成员必须先收窄。 - 收窄方式:
typeof(区分字符串数字布尔)、instanceof(类)、in(属性是否存在)、等值判断===。 - 可辨识联合:每个成员带一个公共字面量字段(如
type: 'success'),switch 这个字段就能精确收窄,default 分支实现穷尽检查。
最小可运行示例:
type Result =
| { type: 'success'; data: string }
| { type: 'error'; message: string }
function handle(r: Result) {
switch (r.type) {
case 'success':
return r.data // 收窄到 success
case 'error':
return r.message // 收窄到 error
default: {
const _exhaustive: never = r // 穷尽检查,漏 case 会报错
return _exhaustive
}
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 访问联合独有属性报错 | 没收窄 | 用 typeof/in/switch 收窄 |
| 改了联合成员 default 不报错 | 没写 never 穷尽检查 | 加 default never |
面试考法:问可辨识联合。能写出上面的 Result 模式即可。
5.4 泛型与工具类型
为什么需要它:写一个请求函数 get<T>(url): Promise<T>,不传死类型,让调用方指定 T,这是大型工程复用的基础。
核心机制:
- 泛型函数:
function identity<T>(x: T): T { return x };调用时identity<string>('a')或让推导。 - 泛型约束:
function pick<T, K extends keyof T>(obj: T, key: K): T[K],K extends keyof T限制 key 必须是对象的键。 - 内置工具类型:
Partial<T>(全可选)、Required<T>(全必选)、Readonly<T>、Pick<T, K>(挑字段)、Omit<T, K>(去掉字段)、Record<K, V>(键值映射)、ReturnType<F>(函数返回值)。
最小可运行示例:
// 手写 Pick
type MyPick<T, K extends keyof T> = { [P in K]: T[P] }
// 通用请求
async function getJSON<T>(url: string): Promise<T> {
const res = await fetch(url)
if (!res.ok) throw new Error(res.statusText)
return res.json() as Promise<T>
}
interface User { id: number; name: string; age: number }
type UserSummary = MyPick<User, 'id' | 'name'>
// { id: number; name: string }
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 泛型退化成 unknown | 没加约束 | 加 T extends xxx |
| keyof 拿不到键 | 对象没用类型标注 | 先给对象标 interface |
面试考法:手写 Pick 与 Omit。Omit<T, K> = Pick<T, Exclude<keyof T, K>>。
5.5 tsconfig 与严格模式
为什么需要它:strict: true 一开,所有隐藏的 null/undefined 问题暴露;不关它等于没写 TS。
核心机制:
strict聚合了noImplicitAny、strictNullChecks、strictFunctionTypes等;新项目必开。target决定编译输出的 JS 版本(ES2020+);module选ESNext;moduleResolution: bundler配合 Vite。skipLibCheck: true跳过 d.ts 检查加快编译;paths配路径别名(如@/*指向src/*)。
最小可运行示例:
{
"compilerOptions": {
"target": "ES2020",
"module": "ESNext",
"moduleResolution": "bundler",
"strict": true,
"skipLibCheck": true,
"baseUrl": ".",
"paths": { "@/*": ["src/*"] },
"noEmit": true
},
"include": ["src"]
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| strictNullChecks 报错一堆 | 以前写的代码没处理 null | 逐个用 ?. 与 ?? 处理 |
| 路径别名在编辑器生效、构建报错 | 没在 vite.config 配 alias | 同步配 Vite resolve.alias |
面试考法:问 strict 包含什么。答 noImplicitAny、strictNullChecks、strictFunctionTypes 等。
5.6 第三方类型与声明
为什么需要它:npm 包很多不带类型,需要 @types/xxx;自己写的工具库要导出 d.ts。
核心机制:
- DefinitelyTyped 社区类型包:
pnpm add -D @types/node @types/react。 - 自己声明:写
declare module 'xxx'给无类型的包补声明;export interface导出公共类型。 - 类型只在编译期存在,运行时被擦除——不要在
if里判断类型是否存在。
最小可运行示例:
// src/types/shims.d.ts
declare module 'untyped-package' {
export function doSomething(input: string): string
}
// 使用
import { doSomething } from 'untyped-package'
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 报 Could not find a declaration file | 没装 @types | pnpm add -D @types/xxx |
| 自定义 .env 变量类型报错 | 没声明 ImportMetaEnv | 在 vite-env.d.ts 里扩展 |
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 写一个 User 类型 | 含必选、可选、readonly、数组字段 | strict 下无报错 | 1 小时 |
| 写可辨识联合 | Result 成功/失败,switch 处理 | default never 穷尽 | 1 小时 |
| 手写 Pick/Omit | 不看内置实现 | 通过类型用例 | 1.5 小时 |
| 配 tsconfig | strict 与 paths 配好 | 编辑器与构建都识别别名 | 1 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 把 any 全部替换 | 一个旧文件里的 any 逐个推导出真实类型 | 无 any 残留 | 2 小时 |
| 修一个联合收窄 bug | 故意访问联合独有属性,用 typeof 修 | 编译器通过 | 1 小时 |
| 给 fetch 加泛型 | getJSON |
不写 as | 1 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 设计一套 API 响应类型 | 分页、错误、成功三种结构 | 调用方能收窄 | 2 小时 |
| 写一个 eventBus 泛型 | on/emit 事件名与 payload 对应 | 错事件名编译报错 | 3 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
Type 'X' is not assignable to type 'Y' |
字面量拓宽或结构不匹配 | 看两个类型差异 | as const 或加字段 |
报 object is possibly 'undefined' |
strictNullChecks | 看哪里没判空 | ?. 与 ?? |
Cannot find module 'xxx' |
没装依赖或类型 | 看是否装 @types | pnpm add -D |
| 路径别名编辑器不认 | tsconfig paths 没配 | 看 tsconfig | 补 paths |
| 库 d.ts 报错 | skipLibCheck 没开 | 看报错来源 | 开 skipLibCheck |
| 泛型退化成 unknown | 缺约束 | 看函数签名 | 加 extends keyof T |
| 穷尽检查不生效 | default 没写 never | 看 switch | 加 default never |
八、出口条件
全部勾选后进入 阶段 3 框架与组件化。
- [ ] 能不用 any 描述一个对象、一个事件回调、一个接口响应
- [ ] 能解释 let/const 推导差异与 as const 的作用
- [ ] 能写可辨识联合并用 switch 收窄,default 写 never
- [ ] 能手写 Pick、Omit、Record 并解释 keyof 与 in
- [ ] 工程开启 strict 无 any,tsconfig 配好 paths 别名
- [ ] 能为无类型的包写 declare module 补声明
自测题:
interface与type怎么选?- 要点:对象与类用 interface,联合交叉用 type。
unknown与any的区别?- 要点:unknown 强制收窄后才能用,any 完全绕过检查。
- 什么是可辨识联合?
- 要点:公共字面量字段 + switch 收窄,default never 穷尽。
- 手写
Omit<T, K>。- 要点:
Pick<T, Exclude<keyof T, K>>。
- 要点:
strict: true打开了哪些检查?- 要点:noImplicitAny、strictNullChecks、strictFunctionTypes 等。
- 为什么类型在运行时不存在?
- 要点:类型被编译期擦除,不要靠类型做运行时判断。