0Pricing
TypeScript Academy · 课时

单体仓库中的增量构建与缓存

使用增量编译和 Turborepo 优化构建时间

单体仓库中的增量构建与缓存 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。

为什么增量构建很重要

在大型单仓库中，每次变更都重新构建每个包会非常缓慢。增量构建会检测发生变化的内容，只重新编译受影响的包。

# Without incremental: all 20 packages rebuild every time
# With incremental: only 2 changed packages rebuild

TypeScript 增量模式

请在 tsconfig 中启用 "incremental": true，以生成 .tsbuildinfo 文件，缓存上一次构建状态，从而快速重新运行。

{
  "compilerOptions": {
    "incremental": true,
    "tsBuildInfoFile": "./.tsbuildinfo"
  }
}

使用 tsc --build 进行项目引用构建

对于项目引用工作区，tsc --build 本身就是增量式的：它会跟踪时间戳，并跳过已经是最新状态的包。

# First build: all packages compiled
tsc --build
# Second build: only changed packages compiled
tsc --build
# [12:00:01 PM] Project 'packages/core' is up to date

Turborepo 缓存

Turborepo 会缓存任务输出（例如 dist/），并在输入未发生变化时从缓存中恢复这些输出，还可以通过远程缓存供整个团队使用。

// turbo.json
{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".tsbuildinfo"]
    }
  }
}

使用 Turborepo 进行远程缓存

请在持续集成机器和团队成员之间共享构建缓存，这样任何人都无需重新构建其他人已经构建过的内容。

# Link to Vercel remote cache
npx turbo login
npx turbo link

Nx 计算缓存

Nx 也提供类似的缓存功能，并根据项目依赖关系图进行细粒度的受影响分析。

# Nx: only test affected projects
npx nx affected --target=test --base=main

缓存输入与输出

为了确保缓存正确，请在构建工具配置中声明所有输入（源文件、环境变量）和输出（dist 目录、tsbuildinfo）。

// turbo.json with inputs
{
  "pipeline": {
    "build": {
      "inputs": ["src/**", "tsconfig.json"],
      "outputs": ["dist/**"]
    }
  }
}

使缓存失效

输入发生变化时，缓存会失效。请避免将易变文件（如日志或时间戳）作为输入，以防止不必要的重新构建。

# Force rebuild even if cached
turbo run build --force

接入持续集成

请将持续集成（GitHub Actions、CircleCI）连接到远程缓存，以便持续集成构建通过复用之前的构建产物来提升速度。

# .github/workflows/ci.yml
- name: Build
  run: npx turbo build
  env:
    TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
    TURBO_TEAM: my-team

仅进行增量类型检查

请使用 tsc --noEmit --incremental 执行快速的仅类型检查持续集成步骤。该命令会跳过输出，同时仍能从缓存中受益。

npx tsc --noEmit --incremental
# Quick type check with .tsbuildinfo cache

回顾：增量构建

单仓库中的增量构建会结合使用 TypeScript 的 tsBuildInfo、tsc --build 以及 Turborepo 或 Nx 缓存，从而尽量减少每次变更所需的编译工作。

快速检查

TypeScript 会生成哪个文件来启用增量构建？

您学到的内容

增量构建使用 TypeScript 的 .tsbuildinfo 文件和 tsc --build 跳过未发生变化的包。Turborepo 和 Nx 通过远程缓存以及仅分析受影响项目，将这一能力扩展到整个单仓库。

常见问题解答

「单体仓库中的增量构建与缓存」课时是免费的吗？

是的 — 「单体仓库中的增量构建与缓存」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。

「单体仓库中的增量构建与缓存」这节课中我会学到什么？

使用增量编译和 Turborepo 优化构建时间 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「单体仓库中的增量构建与缓存」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. TypeScript 项目引用详解
  2. 使用 TypeScript 配置 pnpm 工作区
  3. 共享类型包策略
  4. 单体仓库中的增量构建与缓存
← 返回 TypeScript Academy