tsconfig.json
概述
目录中存在 tsconfig.json 文件表示该目录是 TypeScript 项目的根目录。tsconfig.json 文件指定编译项目所需的根文件和编译器选项。
使用 tsconfig.json
- 通过在没有输入文件的情况下调用 tsc,在这种情况下,编译器将从当前目录开始搜索 tsconfig.json 文件并继续执行父目录链。
- 通过调用没有输入文件的 tsc 和 –project(或只是 -p)命令行选项来指定包含 tsconfig.json 文件的目录的路径。在命令行上指定输入文件时,tsconfig.json 文件是
细节
可以省略 compilerOptions
属性,在这种情况下使用编译器的默认值。请参阅支持的编译器选项的完整列表。
如果 tsconfig.json 中不存在 files
属性,则编译器默认包含所包含目录和子目录中的所有 TypeScript(* .ts 或* .tsx)文件。当存在 files
属性时,仅包含指定的文件。
如果指定了 exclude
属性,则编译器将包含所有包含目录和子目录中的 TypeScript(* .ts 或* .tsx)文件,但排除这些文件或文件夹除外。
files
属性不能与 exclude
属性一起使用。如果两者都指定,则 files
属性优先。
还包括 files
属性中指定的任何文件。类似地,如果文件 B.ts 被另一个文件 A.ts 引用,则除非在 exclude
列表中也指定了引用文件 A.ts,否则不能排除 B.ts。
允许 tsconfig.json
文件完全为空,它使用默认编译器选项编译包含目录和子目录中的所有文件。
命令行中指定的编译器选项会覆盖 tsconfig.json 文件中指定的那些选项。
架构
架构可以在 http://json.schemastore.org/tsconfig 找到