TS学习笔记十二：项目配置

  本节介绍ts项目配置相关内容，包括项目配置文件tsconfig.json的说明及编译选项的内容介绍。

1. 讲解视频
   

   TS学习笔记二十五：TS项目配置

2. B站视频
   

   TS学习笔记二十五：TS项目配置

3. 西瓜视频
   https://www.ixigua.com/7327847796814709288

一、tsconfig.json

  tsconfig.json位于ts项目的根目录中，此文件指定了用来编译这个项目的根目录及编译选项，编译时有以下两种方式：

1. 不带任何输入文件的情况下调用tsc，编译器会从当前目录开始去查找tsconfig.json文件，逐级向上搜索父目录。
2. 不带任何输入文件的情况下调用tsc，且使用命令行参数–project或-p指定一个包含tsconfig.json文件的目录。
3. 当命令行上指定了输入文件时，tsconfig.json文件会被忽略。
   tsconfig.json中使用files属性：

{
   
    "compilerOptions": {
   
        "module": "commonjs",
        "noImplicitAny": true,
        "removeComments": true,
        "preserveConstEnums": true,
        "outFile": "../../built/local/tsc.js",
        "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"
    ]
}

tsconfig.json中使用使用"include"和"exclude"属性：

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

  compilerOptions可以忽略，忽略时编译器会使用默认值，files指向一个包含相对或绝对文件路径的列表，include或exclude属性指定一个文件匹配模式列表，匹配通配符有：

1. *匹配0个或多个字符，不包含目录分隔符
2. ?匹配一个任意字符，不包含目录分隔符
3. **/递归匹配任意子目录

  如果匹配模式中只写了或.，那么只会包含支持的文件扩展名，如默认的.ts、.tsc、.d.ts等。
  如果files和include都没有指定，编译器默认包含当前目录和子目录下所有的ts文件，排除exclude中指定的文件；
  如果files或include指定了，编译器会将他们结合并全部包含进去，使用outDir指定的目录在编译时会被排除在外，除非明确的使用files将其包含了进来。
  使用include引入的文件可以使用exclude属性过滤，但通过files指定的文件却总会被包含，不管exclude中是否指定了排除，默认情况下exclude会排除：node_modules、bower_components，和jspm_packages目录。
  任何被files或include指定的文件所引用的文件也会被包含进来，A.ts引用了B.ts，B.ts不能排除，除非排除了A.ts。
  在最顶层设置complieOnSave标记，IDE会在保存文件的时候自动根据tsconfig.json重新生成文件。

{
   
    "compileOnSave": true,
    "compilerOptions": {
   
        "noImplicitAny" : true
    }
}

二、编译选项

[1] 这些选项是试验性的。
[2] 这些选项只能在tsconfig.json里使用，不能在命令行使用。