JavaScript / TypeScript / 系统课时

优化类型检查性能

优化类型检查性能

当 tsc 或编辑器提示变慢时,真正需要优化的是类型实例化次数、参与检查的文件数量和重复构建范围。本课给出一套可验证的处理顺序:先测量,再简化递归类型,随后收紧工程边界,并用项目引用与增量构建复用结果。

学习目标

  • 使用诊断数据定位类型检查的主要耗时
  • 通过限制递归、复用命名类型降低类型展开成本
  • 用文件范围、项目引用和增量构建缩小重复检查范围

先用诊断数据定位瓶颈

不要先凭感觉删除类型。先在项目根目录执行扩展诊断,记录优化前的基线。Instantiations 很高,通常意味着条件类型、映射类型或递归类型被大量展开;Files 过多,则应优先检查 include、自动引入和项目边界。

bash
npx tsc --noEmit --extendedDiagnostics

预期输出

text
Files:                         <COUNT>
Types:                         <COUNT>
Instantiations:                <COUNT>
Check time:                    <TIME>s
Total time:                    <TIME>s

实际数量和耗时会因机器与项目规模不同。后续每完成一项调整,都用同一条命令复测,重点比较 Files、Instantiations 和 Check time,不要只看总耗时。

简化递归并复用命名类型

无限递归的条件类型会持续展开复杂对象。更稳妥的做法是设置最大深度,并把会重复出现的组合结果提取成命名类型,让编译器更容易缓存和复用。

下面的 src/index.ts 是完整示例。DepthMap 将递归限制在四层;UserView 将重复的交叉类型固定为一个名字,避免在多个函数签名中反复展开。

ts
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"
});

使用临时执行器运行:

bash
npx tsx src/index.ts

预期输出

text
1:Ada:cache

递归深度不是越大越好。只需覆盖真实数据层级;若业务只需要两层只读,就把默认深度降到 2,不要为理论上的任意深度支付持续检查成本。

收紧参与检查的文件范围

include 应只覆盖源代码,生成目录、脚本和独立测试工程应排除或放入单独配置。types 用于限制自动注入的全局类型包,incremental 则复用上次构建信息。

json
{
  "compilerOptions": {
    "strict": true,
    "noEmit": true,
    "incremental": true,
    "tsBuildInfoFile": ".cache/tsconfig.tsbuildinfo",
    "types": ["node"],
    "skipLibCheck": true
  },
  "include": ["src/**/*.ts"],
  "exclude": ["dist", "coverage", "scripts", "**/*.test.ts"]
}

配置保存后检查实际参与编译的文件:

bash
npx tsc -p tsconfig.json --listFiles

预期输出

text
<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,根配置只保存引用,构建时只重查发生变化的部分。

json
{
  "files": [],
  "references": [
    { "path": "./packages/shared" },
    { "path": "./packages/server" },
    { "path": "./packages/web" }
  ]
}

子项目配置至少需要启用 composite,并指定独立的 rootDir 与 outDir。根目录执行以下命令进行增量构建:

bash
npx tsc -b --verbose

预期输出

text
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 基线开始,以数据判断瓶颈
  • 限制递归深度、复用命名类型和收紧文件范围能直接降低检查成本
  • 大型仓库应使用项目引用与增量构建,避免每次检查整个代码库

下一课预告

下一课将把这些手段放入实际排障流程,定位“命令行正常但编辑器类型提示缓慢”的常见原因。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

优化类型检查性能

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

登录哪都通