项目
composite
发布版本: 3.0
composite 选项强制执行某些约束,使得构建工具(包括 TypeScript 自身在 --build 模式下)能够快速确定项目是否已构建。
当此设置开启时:
如果未显式设置
rootDir,则默认为包含tsconfig.json文件的目录。所有实现文件必须由
include模式匹配或在files数组中列出。如果违反此约束,tsc将告知你哪些文件未指定。declaration默认为true
你可以在手册中找到有关 TypeScript 项目的文档。
disableReferencedProjectLoad
- 发布版本: 4.0
在多项目 TypeScript 程序中,TypeScript 会将所有可用项目加载到内存中,以便为需要完整知识图谱的编辑器响应(如“查找所有引用”)提供准确结果。
如果你的项目很大,可以使用 disableReferencedProjectLoad 标志来禁用所有项目的自动加载。取而代之的是,当你通过编辑器打开文件时,项目会动态加载。
disableSolutionSearching
- 发布版本: 3.8
当使用复合 TypeScript 项目时,此选项提供了一种声明方式,表示你不想在编辑器中使用“查找所有引用”或“跳转到定义”等功能时包含该项目。
此标志可用于在大型复合项目中提高响应速度。
disableSourceOfProjectReferenceRedirect
- 发布版本: 3.7
当使用复合 TypeScript 项目时,此选项提供了一种回退到 3.7 之前行为的方法,即使用 d.ts 文件作为模块之间的边界。在 3.7 中,真相来源现在是你的 TypeScript 文件。
incremental
告诉 TypeScript 将上次编译的项目图信息保存到磁盘上的文件中。这会在编译输出所在的同一文件夹中创建一系列 .tsbuildinfo 文件。它们不会被你的 JavaScript 在运行时使用,可以安全删除。你可以在 3.4 发布说明中阅读有关此标志的更多信息。
要控制希望将文件构建到哪些文件夹,请使用配置选项 tsBuildInfoFile。
tsBuildInfoFile
默认值:
.tsbuildinfo发布版本: 3.4
相关: incremental,composite
此设置允许你指定一个文件,用于存储增量编译信息,作为复合项目的一部分,从而实现更快地构建大型 TypeScript 代码库。你可以在手册中阅读有关复合项目的更多信息。
默认值取决于其他设置的组合:
- 如果设置了
outFile,则默认值为<outFile>.tsbuildinfo。 - 如果设置了
rootDir和outDir,则文件为<outDir>/<从 rootDir 到配置的相对路径>/<配置名称>.tsbuildinfo例如,如果rootDir是src,outDir是dest,且配置是./tsconfig.json,则默认值为./tsconfig.tsbuildinfo,因为从src/到./tsconfig.json的相对路径是../。 - 如果设置了
outDir,则默认值为<outDir>/<配置名称>.tsbuildInfo - 否则,默认值为
<配置名称>.tsbuildInfo