文件选项

我们在初始篇中有简单介绍过 tsconfig.json 文件，这里再回顾一下。

回顾

如果一个目录下存在一个 tsconfig.json 文件，那么它意味着这个目录是 TypeScript 项目的根目录。tsconfig.json 文件中指定了用来编译这个项目的根文件和编译选项。 一个项目可以通过以下方式之一来编译：

• 不带任何输入文件的情况下调用 tsc，编译器会从当前目录开始去查找 tsconfig.json文 件，逐级向上搜索父目录。
• 不带任何输入文件的情况下调用 tsc，且使用命令行参数 --project（或 -p ）指定一个包含 tsconfig.json 文件的目录。

当命令行上指定了输入文件时，tsconfig.json文件会被忽略。

本篇主要介绍 tsconfig.json 中与文件相关的选项。

files

它的含义是编译器需要编译的相对或绝对文件路径的单个文件列表。

{
  "files": [
    "src/index.ts"
  ]
}

这时执行 tsc 命令，编译器会编译 src/index.ts 文件。

include

它的含义是编译器需要编译的文件或者目录。

{
  "include": [
    "src"
  ]
}

这时执行 tsc 命令，编译器会编译 src 目录下的所有 ts 文件。

exclude

它的含义是编译器需要排除的文件或者目录。默认会排除 node_modules 目录下的所有文件。

{
  "exclude": [
    "src/lib"
  ]
}

TIP

1. 如果 files 和 includes 都没有指定，编译器默认包含当前目录下所有的 ts 文件。（.ts、.d.ts、.tsx）
2. 如果 exclude 存在，exclude 配置优先级高于 files 和 includes 配置
3. exclude 和 includes 配置支持 glob 通配符：*、?、**

extends

我们可以把一些配置抽离出一个配置文件，再 tsconfig.json 文件引入，方便以后管理与维护。

// tsconfig.json

{
  "extends": "./base.json"
}

在主配置文件中，设置文件选项会覆盖调继承文件中的相同的配置项。

compileOnSave

它可以让 IDE 在保存文件时，编译器自动编译。

{
  "compileOnSave": true
}

目前只有个别 IDE 支持。