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 找到