概述

如果一個目錄下存在一個tsconfig.json文件，那么它意味著這個目錄是TypeScript項目的根目錄。 tsconfig.json文件中指定了用來編譯這個項目的根文件和編譯選項。 一個項目可以通過以下方式之一來編譯：

使用tsconfig.json

當命令行上指定了輸入文件時，tsconfig.json文件會被忽略。

示例

tsconfig.json示例文件:

使用"files"屬性

{  "compilerOptions": {    "module": "commonjs",    "noImplicitAny": true,    "removeComments": true,    "preserveConstEnums": true,    "sourceMap": true  },  "files": [    "core.ts",    "sys.ts",    "types.ts",    "scanner.ts",    "parser.ts",    "utilities.ts",    "binder.ts",    "checker.ts",    "emitter.ts",    "program.ts",    "commandLineParser.ts",    "tsc.ts",    "diagnosticInformationMap.generated.ts"  ]}

使用"include"和"exclude"屬性

{  "compilerOptions": {    "module": "system",    "noImplicitAny": true,    "removeComments": true,    "preserveConstEnums": true,    "outFile": "../../built/local/tsc.js",    "sourceMap": true  },  "include": [    "src/**/*"  ],  "exclude": [    "node_modules",    "**/*.spec.ts"  ]}

細節

"compilerOptions"可以被忽略，這時編譯器會使用默認值。在這里查看完整的編譯器選項列表。

"files"指定一個包含相對或絕對文件路徑的列表。 "include"和"exclude"屬性指定一個文件glob匹配模式列表。 支持的glob通配符有：

如果一個glob模式里的某部分只包含*或.*，那么僅有支持的文件擴展名類型被包含在內（比如默認.ts，.tsx，和.d.ts， 如果allowJs設置能true還包含.js和.jsx）。

如果"files"和"include"都沒有被指定，編譯器默認包含當前目錄和子目錄下所有的TypeScript文件（.ts, .d.ts 和 .tsx），排除在"exclude"里指定的文件。JS文件（.js和.jsx）也被包含進來如果allowJs被設置成true。 如果指定了 "files"或"include"，編譯器會將它們結合一并包含進來。 使用 "outDir"指定的目錄下的文件永遠會被編譯器排除，除非你明確地使用"files"將其包含進來（這時就算用exclude指定也沒用）。

使用"include"引入的文件可以使用"exclude"屬性過濾。 然而，通過 "files"屬性明確指定的文件卻總是會被包含在內，不管"exclude"如何設置。 如果沒有特殊指定， "exclude"默認情況下會排除node_modules，bower_components，jspm_packages和<outDir>目錄。