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

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

1. B站视频 https://www.bilibili.com/video/BV1ca4y1C7WB/

2. 西瓜视频 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里使用，不能在命令行使用。