JavaScript / TypeScript / 系统课时

启用增量构建

启用增量构建

TypeScript 增量构建会保存上一次编译的结构信息,避免每次都从头分析整个项目;监听模式进一步让编译进程常驻,只处理受影响的变化。多包仓库再配合项目引用,可以把文件级增量扩展为项目级增量。

学习目标

  • 使用 incremental 和 tsBuildInfoFile 复用上次构建信息
  • 用监听模式缩短连续修改代码时的反馈时间
  • 通过项目引用让多包仓库只重建受影响的依赖链

为单项目开启增量信息

普通项目只需要启用 incremental,编译器就能保存上一轮构建状态。.tsbuildinfo 记录输入文件版本、签名和构建信息,它属于可再生的编译缓存,不是应用运行时需要读取的业务文件。

json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "outDir": "./dist",
    "incremental": true,
    "tsBuildInfoFile": "./.tsbuildinfo",
    "strict": true
  },
  "include": ["src/**/*.ts"]
}

首次执行编译:

bash
npx tsc

预期结果:

text
<默认成功时无控制台输出;退出码为 0>

首次构建会生成 dist 和 .tsbuildinfo。源码没有变化时再次执行同一命令,编译器可以复用已有状态;删除 .tsbuildinfo 后,下一次构建则需要重新建立增量信息。

用监听模式复用常驻编译上下文

本地开发时,--watch 比反复手动启动 tsc 更适合高频修改。编译器保持文件监听器和程序结构,只在文件变化后重新计算受影响的部分,因此通常能更快给出下一轮类型检查结果。

bash
npx tsc --watch

预期输出:

text
<TIME> - Starting compilation in watch mode...
<TIME> - Found 0 errors. Watching for file changes.

实际时间会不同。监听模式优化的是连续开发反馈,并不等于生产构建缓存;CI 仍应以一次构建命令的退出码、类型错误和最终产物作为验收依据。

TypeScript 增量构建、监听模式与项目引用的工作关系

用项目引用扩展到多包仓库

多包项目不要只靠一个巨大的 include 覆盖所有源码。让每个包成为 composite 项目,再在仓库根配置中使用 references 描述项目关系,tsc -b 就能根据依赖图和已有构建信息判断哪些项目需要更新。

根目录 tsconfig.json:

json
{
  "files": [],
  "references": [
    { "path": "./packages/core" },
    { "path": "./packages/app" }
  ]
}

packages/core/tsconfig.json:

json
{
  "compilerOptions": {
    "composite": true,
    "incremental": true,
    "declaration": true,
    "outDir": "./dist",
    "tsBuildInfoFile": "./dist/core.tsbuildinfo"
  },
  "include": ["src/**/*.ts"]
}

packages/app/tsconfig.json 除了自身编译选项,还声明对 core 的引用:

json
{
  "compilerOptions": {
    "composite": true,
    "incremental": true,
    "outDir": "./dist",
    "tsBuildInfoFile": "./dist/app.tsbuildinfo"
  },
  "references": [
    { "path": "../core" }
  ],
  "include": ["src/**/*.ts"]
}

这些配置的价值不是简单拆分配置文件,而是让 TypeScript 获得明确的项目边界和依赖图。作为项目引用目标的包需要满足 composite 约束,构建模式才能可靠判断其输出是否已经过期。

用构建模式执行和验证

在仓库根目录执行构建模式:

bash
npx tsc -b

预期结果:

text
<默认成功时无控制台输出;退出码为 0>

首次运行会按引用关系构建需要更新的项目。随后只修改 app 时,未变化的 core 可以复用既有结果;如果修改 core 的公开类型,依赖它的项目会被重新检查,从而避免包之间出现陈旧类型信息。

需要持续开发整个仓库时,可以组合构建模式和监听模式:

bash
npx tsc -b --watch

预期输出:

text
<TIME> - Starting compilation in watch mode...
<TIME> - Found 0 errors. Watching for file changes.

在结构性变化后主动清理缓存

.tsbuildinfo 应被视为可以重新生成的构建状态。升级 TypeScript、调整 rootDir、outDir、路径映射或项目引用关系后,如果出现明显与源码不一致的构建行为,可以先停止监听进程,再执行一次干净构建。

bash
npx tsc -b --clean && npx tsc -b

预期结果:

text
<默认成功时无控制台输出;退出码为 0>

增量构建的目标不是永远避免全量工作,而是在项目边界稳定时尽量复用已有状态,在编译配置或依赖图发生结构性变化时主动重建缓存。这样既能获得更快的日常反馈,也不会让陈旧构建信息长期掩盖配置问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

启用增量构建

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

登录哪都通