复合项目 - 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