784 words
4 minutes
TSConfig 项目配置
2025-02-27 10:37:28
2025-12-24 23:45:46

← 返回 TSConfig 参考指南


复合项目 - composite#

composite 选项强制执行某些约束,使构建工具(包括 TypeScript 本身在 —build 模式下)能够快速确定项目是否已经构建。

当启用此设置时:

  • 如果没有显式设置 rootDir,它将默认为包含 tsconfig.json 文件的目录。
  • 所有实现文件必须匹配 include 模式或列在 files 数组中。如果违反此约束,tsc 将告知你哪些文件未被指定。
  • declaration 默认为 true

你可以在手册中找到关于 TypeScript 项目的文档。

相关配置:

  • incremental
  • tsBuildInfoFile

发布版本:3.0

禁用引用项目加载 - disableReferencedProjectLoad#

在多项目 TypeScript 程序中,TypeScript 会将所有可用的项目加载到内存中,以便为需要完整知识图谱的编辑器响应(如”查找所有引用”)提供准确的结果。

如果你的项目很大,你可以使用 disableReferencedProjectLoad 标志来禁用自动加载所有项目。相反,项目会在你通过编辑器打开文件时动态加载。

发布版本:4.0

禁用解决方案搜索 - disableSolutionSearching#

在使用复合 TypeScript 项目时,此选项提供了一种方式来声明你不希望在使用编辑器的”查找所有引用”或”跳转到定义”等功能时包含某个项目。

这个标志可以用来提高大型复合项目的响应速度。

发布版本:3.8

禁用项目引用源重定向 - disableSourceOfProjectReferenceRedirect#

在使用复合 TypeScript 项目时,此选项提供了一种方式来回到 3.7 版本之前的行为,即使用 d.ts 文件作为模块之间的边界。在 3.7 版本中,真实来源现在是你的 TypeScript 文件。

发布版本:3.7

增量编译 - incremental#

告诉 TypeScript 将上次编译的项目图信息保存到磁盘上的文件中。这会在编译输出的同一文件夹中创建一系列 .tsbuildinfo 文件。这些文件在运行时不会被你的 JavaScript 使用,可以安全删除。你可以在 3.4 版本的发布说明中阅读更多关于此标志的信息。

要控制你想要构建文件的文件夹,请使用配置选项 tsBuildInfoFile。

默认值: 如果启用了 composite 则为 true;否则为 false。

相关配置:

  • composite
  • tsBuildInfoFile

发布版本:3.4

TS 构建信息文件 - tsBuildInfoFile#

此设置允许你指定一个文件来存储增量编译信息,作为复合项目的一部分,这可以加快更大的 TypeScript 代码库的构建速度。你可以在手册中阅读更多关于复合项目的信息。

默认值取决于其他设置的组合:

  • 如果设置了 outFile,则默认为.tsbuildinfo
  • 如果设置了 rootDir 和 outDir,则文件为/<从 rootDir 到配置的相对路径>/<配置名>.tsbuildinfo。例如,如果 rootDir 是 src,outDir 是 dest,配置是 ./tsconfig.json,则默认为 ./tsconfig.tsbuildinfo,因为从 src/ 到 ./tsconfig.json 的相对路径是 ../
  • 如果设置了 outDir,则默认为/<配置名>.tsbuildInfo
  • 否则,默认为 <配置名>.tsbuildInfo

默认值:.tsbuildinfo

相关配置:

  • incremental
  • composite

发布版本:3.4

TSConfig 项目配置
https://0bipinnata0.my/posts/typescript/tsconfig/10-projects/
Author
0bipinnata0
Published at
2025-02-27 10:37:28