TypeScript（简称 TS）已经成为前端开发领域的瑞士军刀，它为 JavaScript 带来了类型检查、代码提示和更好的代码组织能力。在 TypeScript 项目中，tsconfig.json 文件扮演着至关重要的角色，它定义了 TypeScript 编译器的行为和项目的结构。本文将深入探讨tsconfig.json配置项，帮助您更好地理解如何配置和优化您的 TypeScript 项目。
什么是 tsconfig.json？
tsconfig.json 是 TypeScript 项目的配置文件，它用于指导 TypeScript 编译器（tsc）如何编译项目。这个文件是一个 JSON 格式的文本文件，位于项目的根目录下。当您运行tsc命令时，TypeScript 编译器会根据tsconfig.json中的配置来编译 TypeScript 代码。现代的编辑器例如vscode等都会利用tsconfig.json来进行类型检查，代码提示，路径解析，模块导入等功能。
如何配置tsconfig.json？
只需要在项目根目录下新建tsconfig.json即可，可以手动创建或者通过命令行tsc --init来创建。
删除注释掉的配置后得到最简单的配置项如下
{
"compilerOptions": {
"target": "es2016",
"module": "commonjs" /* Specify what module code is generated. */,
"esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
"forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
"strict": true /* Enable all strict type-checking options. */,
"skipLibCheck": true /* Skip type checking all .d.ts files. */
}
}配置项详情
"compilerOptions"不是非必需，这时编译器会使用默认值
"files"指定一个包含相对或绝对文件路径的列表。 "include"和"exclude"属性指定一个文件glob匹配模式列表。 支持的glob通配符有：
*匹配0或多个字符（不包括目录分隔符）?匹配一个任意字符（不包括目录分隔符）**/递归匹配任意子目录
如果一个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>目录。
任何被"files"或"include"指定的文件所引用的文件也会被包含进来。 A.ts引用了B.ts，因此B.ts不能被排除，除非引用它的A.ts在"exclude"列表中。
需要注意编译器不会去引入那些可能做为输出的文件；比如，假设我们包含了index.ts，那么index.d.ts和index.js会被排除在外。 通常来讲，不推荐只有扩展名的不同来区分同目录下的文件。
tsconfig.json文件可以是个空文件，那么所有默认的文件（如上面所述）都会以默认配置选项编译。
在命令行上指定的编译选项会覆盖在tsconfig.json文件里的相应选项。
@types，typeRoots和types
默认所有可见的"@types"包会在编译过程中被包含进来。 node_modules/@types文件夹下以及它们子文件夹下的所有包都是可见的； 也就是说， ./node_modules/@types/，../node_modules/@types/和../../node_modules/@types/等等。
如果指定了typeRoots，只有typeRoots下面的包才会被包含进来。 比如：
{
"compilerOptions": {
"typeRoots": ["./typings"]
}
}这个配置文件会包含所有./typings下面的包，而不包含./node_modules/@types里面的包。
如果指定了types，只有被列出来的包才会被包含进来。 比如：
{
"compilerOptions": {
"types": ["node", "lodash", "express"]
}
}这个tsconfig.json文件将仅会包含 ./node_modules/@types/node，./node_modules/@types/lodash和./node_modules/@types/express。/@types/。 node_modules/@types/*里面的其它包不会被引入进来。
指定"types": []来禁用自动引入@types包。
注意，自动引入只在你使用了全局的声明（相反于模块）时是重要的。 如果你使用 import "foo"语句，TypeScript仍然会查找node_modules和node_modules/@types文件夹来获取foo包。
使用extends继承配置
tsconfig.json文件可以利用extends属性从另一个配置文件里继承配置。
extends是tsconfig.json文件里的顶级属性（与compilerOptions，files，include，和exclude一样）。 extends的值是一个字符串，包含指向另一个要继承文件的路径。
在原文件里的配置先被加载，然后被来至继承文件里的配置重写。 如果发现循环引用，则会报错。
来至所继承配置文件的files，include和exclude覆盖源配置文件的属性。
配置文件里的相对路径在解析时相对于它所在的文件。
比如：
configs/base.json：
{
"compilerOptions": {
"noImplicitAny": true,
"strictNullChecks": true
}
}tsconfig.json：
{
"extends": "./configs/base",
"files": ["main.ts", "supplemental.ts"]
}tsconfig.nostrictnull.json：
{
"extends": "./tsconfig",
"compilerOptions": {
"strictNullChecks": false
}
}compileOnSave
在最顶层设置compileOnSave标记，可以让IDE在保存文件的时候根据tsconfig.json重新生成文件。
{
"compileOnSave": true,
"compilerOptions": {
"noImplicitAny": true
}
}要想支持这个特性需要Visual Studio 2015， TypeScript1.8.4以上并且安装atom-typescript插件。
