JavaScript / TypeScript / 系统课时
优化类型检查性能
优化类型检查性能
当 tsc 或编辑器提示变慢时,真正需要优化的是类型实例化次数、参与检查的文件数量和重复构建范围。本课给出一套可验证的处理顺序:先测量,再简化递归类型,随后收紧工程边界,并用项目引用与增量构建复用结果。
学习目标
- 使用诊断数据定位类型检查的主要耗时
- 通过限制递归、复用命名类型降低类型展开成本
- 用文件范围、项目引用和增量构建缩小重复检查范围
先用诊断数据定位瓶颈
不要先凭感觉删除类型。先在项目根目录执行扩展诊断,记录优化前的基线。Instantiations 很高,通常意味着条件类型、映射类型或递归类型被大量展开;Files 过多,则应优先检查 include、自动引入和项目边界。
npx tsc --noEmit --extendedDiagnostics预期输出
Files: <COUNT>
Types: <COUNT>
Instantiations: <COUNT>
Check time: <TIME>s
Total time: <TIME>s实际数量和耗时会因机器与项目规模不同。后续每完成一项调整,都用同一条命令复测,重点比较 Files、Instantiations 和 Check time,不要只看总耗时。
简化递归并复用命名类型
无限递归的条件类型会持续展开复杂对象。更稳妥的做法是设置最大深度,并把会重复出现的组合结果提取成命名类型,让编译器更容易缓存和复用。
下面的 src/index.ts 是完整示例。DepthMap 将递归限制在四层;UserView 将重复的交叉类型固定为一个名字,避免在多个函数签名中反复展开。
type Primitive = string | number | boolean | bigint | symbol | null | undefined;
type DepthMap = [never, 0, 1, 2, 3, 4];
type DeepReadonly<T, D extends number = 4> =
D extends 0
? T
: T extends Primitive | Function
? T
: T extends readonly (infer U)[]
? ReadonlyArray<DeepReadonly<U, DepthMap[D]>>
: T extends object
? { readonly [K in keyof T]: DeepReadonly<T[K], DepthMap[D]> }
: T;
interface User {
id: number;
profile: {
name: string;
tags: string[];
};
}
type UserView = DeepReadonly<User> & { readonly source: "cache" };
function printUser(user: UserView): void {
console.log(`${user.id}:${user.profile.name}:${user.source}`);
}
printUser({
id: 1,
profile: { name: "Ada", tags: ["admin"] },
source: "cache"
});使用临时执行器运行:
npx tsx src/index.ts预期输出
1:Ada:cache递归深度不是越大越好。只需覆盖真实数据层级;若业务只需要两层只读,就把默认深度降到 2,不要为理论上的任意深度支付持续检查成本。
收紧参与检查的文件范围
include 应只覆盖源代码,生成目录、脚本和独立测试工程应排除或放入单独配置。types 用于限制自动注入的全局类型包,incremental 则复用上次构建信息。
{
"compilerOptions": {
"strict": true,
"noEmit": true,
"incremental": true,
"tsBuildInfoFile": ".cache/tsconfig.tsbuildinfo",
"types": ["node"],
"skipLibCheck": true
},
"include": ["src/**/*.ts"],
"exclude": ["dist", "coverage", "scripts", "**/*.test.ts"]
}配置保存后检查实际参与编译的文件:
npx tsc -p tsconfig.json --listFiles预期输出
<PATH>/node_modules/typescript/lib/lib.es5.d.ts
<PATH>/node_modules/@types/node/index.d.ts
<PATH>/src/index.ts实际路径和声明文件数量可能不同。exclude 不能阻止被源文件显式导入的文件进入编译;若生成代码仍被检查,应从导入关系或目录结构上隔离。
skipLibCheck 能跳过依赖声明文件的完整检查,通常可明显提速,但也可能掩盖第三方声明之间的冲突。应用项目可以谨慎启用,发布类型声明的库项目则应保留完整检查。
用项目引用拆分大型工程
当一个仓库包含前端、服务端和共享类型时,可将它们拆成独立 TypeScript 项目。每个子项目启用 composite,根配置只保存引用,构建时只重查发生变化的部分。
{
"files": [],
"references": [
{ "path": "./packages/shared" },
{ "path": "./packages/server" },
{ "path": "./packages/web" }
]
}子项目配置至少需要启用 composite,并指定独立的 rootDir 与 outDir。根目录执行以下命令进行增量构建:
npx tsc -b --verbose预期输出
Project '<PATH>/packages/shared/tsconfig.json' is up to date
Project '<PATH>/packages/server/tsconfig.json' is up to date
Project '<PATH>/packages/web/tsconfig.json' is up to date首次构建会实际编译各项目;再次执行时,未变化的项目应显示为最新状态。若所有子项目每次都重建,检查输出目录是否被清理、引用路径是否正确,以及 .tsbuildinfo 是否被持续删除。
验证优化是否有效
优化完成后,重新运行扩展诊断,并与基线对比。有效改动通常会减少文件数、类型实例化次数或检查时间中的至少一项;若指标没有变化,就撤销无效调整,避免仅增加配置复杂度。
编辑器仍然卡顿时,还要确认问题是否来自语言服务而非命令行编译。可重启 TypeScript Server 后再观察;若命令行很快但编辑器持续缓慢,重点排查自动导入范围、超大联合类型和单个巨型声明文件。
本课总结
- 性能优化应从
--extendedDiagnostics基线开始,以数据判断瓶颈 - 限制递归深度、复用命名类型和收紧文件范围能直接降低检查成本
- 大型仓库应使用项目引用与增量构建,避免每次检查整个代码库
下一课预告
下一课将把这些手段放入实际排障流程,定位“命令行正常但编辑器类型提示缓慢”的常见原因。