配置文件

$ tsc --init

{
  "compilerOptions": {
        "target": "es2016",
        /*等同于编译命令中的target，指定要输出的JavaScript版本*/
        "module": "commonjs",
        /*指定将涉及模块的代码转换成哪种模块规范下的代码*/
        "esModuleInterop": true,
        /*兼容性选项，允许从没有设置过默认导出的模块中默认导入，仅为了通过类型检查*/
        "forceConsistentCasingInFileNames": true,
        /*涉及模块导入时，文件名中的大小写都需要匹配*/
        "strict": true,
        /*启用严格的类型检查选项*/
        "skipLibCheck": true
        /*忽略所有以".d.ts"为后缀的文件的编译检查*/
  }
}

D:\TSProject
│  a.ts
│  tsconfig.json
│
├─folder1
│      b.ts
│
└─folder2
        c.ts
        tsconfig.json

> {
>     "compilerOptions": {
>         "target": "es2016",
>         "module": "commonjs",
>         "esModuleInterop": true,
>         "forceConsistentCasingInFileNames": true,
>         "strict": true,
>         "skipLibCheck": true
>     },
>     "files": [
>         "./a.ts",
>         "./folder1/b.ts",
>         "./folder2/c.ts"
>     ]
> }

$ tsc --project 配置文件路径或其所在目录路径

D:\TSProject
├─project1
│      a.ts
│      tsconfig.json
│      tsconfig.version2.json
│
└─project2
        b.ts
        tsconfig.json

D:\TSProject
├─src
│  │  a.ts
│  │
│  └─subfolder
│          b.ts
│
└─testing
        c.ts

{
  "compilerOptions": {
    /*访问 https://aka.ms/tsconfig.json 可查看完整的编译选项*/

    /*基础选项*/
    "target": "es5"
    /*target用于指定编译后.js文件遵循的目标版本——'ES3' (default), 'ES5', 'ES2015', 'ES2016',
    'ES2017', 'ES2018', 'ES2019'或'ESNEXT'*/
    "module": "commonjs"
    /*用来指定编译后的.js文件所使用的模块标准——'none', 'commonjs', 'amd', 'system', 'umd',
    'es2015'或'ESNext'.*/
    "lib": ["es6", "dom"]
    /*lib用于指定要包含在编译中的库文件*/
    "allowJs": true,
    /*allowJs设置的值为true或false，用来指定是否允许编译.js文件，默认是false，即不编译.js
    文件*/
    "checkJs": true,
    /*checkJs的值为true或false，用来指定是否检查和报告.js文件中的错误，默认是false*/
    "jsx": "preserve",
    /*指定jsx代码用于的开发环境——'preserve', 'react-native'或'react'.*/
    "declaration": true,
    /*declaration的值为true或false，用来指定是否在编译的时候生成相应的".d.ts"声明文件。如果
    设为true，编译每个.ts文件后会生成一个.js文件和一个声明文件。但是declaration和allowJs不
    能同时设为true*/
    "declarationMap": true,
    /* declarationMap的值为true或false，指定是否为声明文件.d.ts生成.map文件*/
    "sourceMap": true,
    /*sourceMap的值为true或false，用来指定编译时是否生成.map文件*/
    "outFile": "./",
    /*outFile用于指定将输出文件合并为一个文件，它的值为一个文件路径名。例如，若设置为"./dist/
    main.js"，则输出的文件为一个main.js文件。但是要注意，只有设置module的值为amd模块和system
    模块时才支持这个配置*/
    "outDir": "./",
    /*outDir用来指定输出文件夹，它的值为一个文件夹路径字符串，输出的文件都将放置在这个文件夹中*/
    "rootDir": "./",
    /*用来指定编译文件的根目录，编译器会在根目录中查找入口文件*/
    "composite": true,
    /*是否生成.tsbuildinfo文件，以此判断是否启用增量编译，tsconfig.tsbuildinfo文件存储了本
    次编译时各个文件的版本（文件MD5）信息，当下次再进行编译时，将用于判断是否需要重新编译各个文件*/
    "incremental": true,
    /*启用增量编译*/
    "tsBuildInfoFile": "./",
    /*指定用于存储增量编译信息的文件，从而可以更快地构建规模更大的TypeScript项目*/
    "removeComments": true,
    /*removeComments的值为true或false，用于指定是否将编译后的文件中的注释删掉，若设为true，
    删掉注释，默认为false*/
    "noEmit": true,
    /*不生成编译文件，仅进行编译检查*/
    "importHelpers": true,
    /*importHelpers的值为true或false，指定是否引入tslib里的辅助工具函数，默认为false*/
    "downlevelIteration": true,
    /*当target为'ES5'或'ES3'时，为'for-of'、spread和destructuring中的迭代器提供完全支持*/
    "isolatedModules": true,
    /*isolatedModules的值为true或false，指定是否将每个文件作为单独的模块，默认为true，它不
    可以和declaration同时设定*/
    /*严格类型检查选项*/
    "strict": true
    /*strict的值为true或false，用于指定是否启动所有类型检查，如果设为true，则会同时开启下面这
    几个严格类型检查，默认为false*/,
    "noImplicitAny": true,
    /*noImplicitAny的值为true或false，如果没有为一些值设置明确的类型，编译器会默认为any，如
    果noImplicitAny的值为true，则没有明确的类型会报错，默认为false*/
    "strictNullChecks": true,
    /*strictNullChecks为true时，null和undefined不能赋给非这两种类型的变量，别的类型也不能
    赋给它们，除any类型之外。还有个例外是undefined可以赋给void类型*/
    "strictFunctionTypes": true,
    /*strictFunctionTypes的值为true或false，用于指定是否使用函数参数双向协变检查*/
    "strictBindCallApply": true,
    /*设为true后，对bind、call和apply绑定的方法的参数的检测是严格的*/
    "strictPropertyInitialization": true,
    /*设为true后会检查类的非undefined属性是否已经在构造函数里初始化，如果要开启该选项，需要同
    时开启strictNullChecks，默认为false*/
    "noImplicitThis": true,
    /*当this表达式的值为any类型的时候，生成一个错误*/
    "alwaysStrict": true,
    /*alwaysStrict的值为true或false，指定始终以严格模式检查每个模块，并且在编译之后的.js文
    件中加入"use strict"字符串，用来告诉浏览器该js为严格模式*/

    /*额外检查*/
    "noUnusedLocals": true,
    /*用于检查是否有定义了但是没有使用的变量，对于这一点的检测，eslint可以在书写代码的时候做提示，
    可以配合使用。默认为false*/
    "noUnusedParameters": true,
    /*用于检查在函数体中是否有没有使用的参数，也可以配合eslint来做检查，默认为false*/
    "noImplicitReturns": true,
    /*用于检查函数是否有返回值，设为true后，如果函数没有返回值，则会提示，默认为false*/
    "noFallthroughCasesInSwitch": true,
    /*用于检查switch中是否有case没有使用break跳出，默认为false*/

    /*模块相关选项*/
    "moduleResolution": "node",
    /*用于选择模块解析策略，有"node"和"classic"两种类型*/
    "baseUrl": "./",
    /*baseUrl用于设置解析非相对模块名称的基本目录，相对模块的目录不会受baseUrl的影响*/
    "paths": {},
    /*用于设置模块名称到基于baseUrl的路径映射*/
    "rootDirs": [],
    /*rootDirs可以指定一个路径列表，在构建时编译器时会将这个路径列表中的路径的内容都放到一个文件
    夹中*/
    "typeRoots": [],
    /*typeRoots用来指定声明文件或文件夹的路径列表，如果指定了此项，则只有在这里列出的声明文件才
    会被加载*/
    "types": [],
    /*types用来指定需要包含的模块，只有在这里列出的模块的声明文件才会被加载*/
    "allowSyntheticDefaultImports": true,
    /*用来指定允许从没有默认导出的模块中默认导入*/
    "esModuleInterop": true
    /*通过为导入内容创建命名空间，实现CommonJS和ES模块之间的互操作*/,
    "preserveSymlinks": true,
    /*不把符号链接解析为真实路径，具体可以了解Webpack和Node.js的SymLink*/

    /*源文件映射选项*/
    "sourceRoot": "",
    /*sourceRoot用于指定调试器应该找到TypeScript文件而不是源文件位置，它会被写进.map文件里*/
    "mapRoot": "",
    /*mapRoot用于指定调试器找到映射文件而非生成文件的位置，指定.map文件的根路径，该选项会影
    响.map文件中的sources属性*/
    "inlineSourceMap": true,
    /*指定是否将.map文件的内容和.js文件编译在同一个.js文件中，如果设为true，则map的内容会以
    "//# sourceMappingURL="开头并且拼接base64字符串的形式插入在.js文件底部*/
    "inlineSources": true,
    /*用于指定是否进一步将.ts文件的内容也包含到输入文件中*/

    /*实验性选项*/
    "experimentalDecorators": true
    /*用于指定是否启用实验性的装饰器特性*/
    "emitDecoratorMetadata": true,
    /*用于指定是否为装饰器提供元数据支持，元数据也是ES6的新标准，可以通过Reflect提供的静态方法
    获取，如果需要使用Reflect的方法，则需要引入ES2015.Reflect这个库*/
  }
}

{
  …
  "extends": "配置文件路径"
}

D:\TSProject
│  tsconfig.json
│
├─base
│      tsconfig.base.json
│
└─src
        a.ts

{
    "compilerOptions": {
       "target": "ESNext"
    }
}

{
  "compilerOptions": {
    "module": "CommonJS"
  },
  "extends": "./base/tsconfig.base.json"
}

> {
>     "compilerOptions": {
>         "target": "esnext",
>         "module": "commonjs"
>     },
>     "files": [
>         "./src/a.ts"
>     ]
> }

{
  "compilerOptions": {
    "module": "CommonJS",
    "target": "ES3"
  },
  "extends": "./base/tsconfig.base.json"
}

> {
>     "compilerOptions": {
>         "target": "es3",
>         "module": "commonjs"
>     },
>     "files": [
>         "./src/a.ts"
>     ]
> }

{
    "compilerOptions": {
       "target": "ESNext"
    },
    "include": ["src"]
}

> error TS18003: No inputs were found in config file 'D:/TSProject/tsconfig.json'.
Specified 'include' paths were '["base/src"]' and 'exclude' paths were '[]'.

{
    "compilerOptions": {
       "target": "ESNext"
    },
    "include": ["../src"]
}

> {
>     "compilerOptions": {
>         "target": "es3",
>         "module": "commonjs"
>     },
>     "files": [
>         "./src/a.ts"
>     ],
>     "include": [
>         "base/../src"
>     ]
> }

{
  /*布尔类型，可以让 IDE 在保存文件的时候根据 tsconfig.json 重新生成编译后的文件*/
  "compileOnSave": true,
  /*构建选项，主要适用于--build命令*/
  "buildOptions": {
    /*使用此选项后，TypeScript将避免重新检查及构建全部文件，而只重新检查/构建已更改的文件以及直
    接导入它们中的文件*/
    "assumeChangesOnlyAffectDirectDependencies": false,
    /*显示将要执行的操作但是并不真正进行这些操作*/
    "dry": false,
    /*强制把所有项目当作非最新版本对待*/
    "force": false,
    /*输出详细的日志*/
    "verbose": false,
    /*是否生成.tsbuildinfo文件，以此判断是否启用增量编译，tsconfig.tsbuildinfo文件存储了本
    次编译中各个文件的版本（文件MD5）信息，当下次再进行编译时，将用于判断是否需要重新编译各个文件*/
    "incremental": false,
    /*如果要检查模块为什么没包含进来，可将其设置为true，以便输出相关文件的解析过程信息*/
    "traceResolution": false
  },
  /*配置使用哪种监听策略来跟踪文件和目录*/
  "watchOptions": {
    /*字符串数组，用于指定不需要监听变化的目录*/
    "excludeDirectories": ["无须监听的目录1","无须监听的目录2"],
    /*字符串数组，用于指定不需要监听变化的文件*/
    "excludeFiles": ["无须监听的文件1","无须监听的文件2"],
    /*是否同步监听文件变化*/
    "synchronousWatchDirectory": true,
    /*目录监听策略，可设置为以下值*/
    /*usefsevents，采用操作系统的文件系统的原生事件机制监听目录更改*/
    /*fixedpollinginterval，以固定的时间间隔检查各目录的更改数次*/
    /*dynamicprioritypolling，根据目录的修改频率动态调整监听频次*/
    "watchDirectory": "usefsevents",
    /*文件监听策略，可以设置为以下值*/
    /*usefsevents，采用操作系统的文件系统的原生事件机制监听文件更改*/
    /*fixedpollinginterval，以固定的时间间隔检查各文件的更改数次*/
    /*prioritypollinginterval，以固定时间间隔检查各文件的更改次数，但根据文件类型有不同的频次*/
    /*dynamicprioritypolling，根据文件的修改频率动态调整监听频次*/
    /*usefseventsonparentdirectory，采用操作系统的文件系统的原生事件机制监听父级目录更改*/
    "watchFile": "usefsevents",
    /*当采用操作系统的文件系统的原生事件机制监听文件时，此选项指定本机的文件监听器被耗尽或者不支持
    本机文件监听器时编译器采用轮询策略，可设置为以下值*/
    /*fixedinterval，以固定的时间间隔检查各文件的更改数次*/
    /*priorityinterval，以固定的时间间隔检查各文件的更改次数，但根据文件类型有不同的频次*/
    /*dynamicpriority，根据文件的修改频率动态调整监听频次*/
    "fallbackPolling": "dynamicpriority"
  }
}