Typescript编译器配置选项

Typescript

Typescript是Javascript的超集，由微软开发和开源。
通俗的理解为Javascript的一个特殊版本，其语法规范严谨，适用于开发大型项目。

安装

npm i typescript -g

验证是否安装成功

tsc -v

编译

手动编译

创建一个index.ts，并在其中写一行普通的js代码
在命令行中，进入到指定的目录，执行命令tsc index.ts进行编译，在同级目录下会生成一个同名的js文件

自动编译（vscode）

生成ts配置文件

tsc --init
此时，就会在指定的目录下生成一个tsconfig.json的配置 

tsc [文件名] -w 自动监听ts文件变化

完整版

{
"compilerOptions": {
    /* 基本选项 */
    "target": "es5",// 指定 ECMAScript 目标版本: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', or 'ESNEXT'
    "module": "commonjs",// 指定使用模块: 'commonjs', 'amd', 'system', 'umd' or 'es2015'
    "lib": [],// 指定要包含在编译中的库文件
    "allowJs": true,//允许编译 javascript 文件
    "checkJs": true,//报告javascript文件中的错误
    "jsx": "preserve",//指定jsx代码的生成: 'preserve', 'react-native', or 'react'
    "declaration": true,//生成相应的 '.d.ts' 文件
    "sourceMap": true, //生成相应的 '.map' 文件
    "outFile": "./",//将输出文件合并为一个文件
    "outDir": "./",//指定输出目录
    "rootDir": "./",//用来控制输出目录结构 --outDir.
    "removeComments": true,//删除编译后的所有的注释
    "noEmit": true,//不生成输出文件
    "importHelpers": true,//从tslib导入辅助工具函数
    "isolatedModules": true,//将每个文件做为单独的模块（与 'ts.transpileModule' 类似）.
    /* 严格的类型检查选项 */
    "strict": true,//启用所有严格类型检查选项
    "noImplicitAny": true,//在表达式和声明上有隐含的any类型时报错
    "strictNullChecks": true,//启用严格的null检查
    "noImplicitThis": true,//当this表达式值为 any 类型的时候，生成一个错误
    "alwaysStrict": true,//以严格模式检查每个模块，并在每个文件里加入 'use strict'
    /* 额外的检查 */
    "noUnusedLocals": true,//有未使用的变量时，抛出错误
    "noUnusedParameters": true,//有未使用的参数时，抛出错误
    "noImplicitReturns": true,//并不是所有函数里的代码都有返回值时，抛出错误
    "noFallthroughCasesInSwitch": true,//报告switch语句的fallthrough错误。
    /* 模块解析选项 */
    "moduleResolution": "node",//选择模块解析策略：'node' (Node.js) or 'classic' (TypeScript pre-1.6)
    "baseUrl": "./",//用于解析非相对模块名称的基目录
    "paths": {},//模块名到基于 baseUrl 的路径映射的列表
    "rootDirs": [],//根文件夹列表，其组合内容表示项目运行时的结构内容
    "typeRoots": [],//包含类型声明的文件列表
    "types": [],//需要包含的类型声明文件名列表
    "allowSyntheticDefaultImports": true, //允许从没有设置默认导出的模块中默认导入。
    /* Source Map Options */
    "sourceRoot": "./",//指定调试器应该找到 TypeScript 文件而不是源文件的位置
    "mapRoot": "./",//指定调试器应该找到映射文件而不是生成文件的位置
    "inlineSourceMap": true,//生成单个 soucemaps 文件，而不是将 sourcemaps 生成不同的文件
    "inlineSources": true,//将代码与 sourcemaps 生成到一个文件中，要求同时设置了 --inlineSourceMap 或 --sourceMap 属性
    /* 其他选项 */
    "experimentalDecorators": true,//启用装饰器
    "emitDecoratorMetadata": true//为装饰器提供元数据的支持
  }
}
 
注意：需要什么配置，将其注释解开配置正确即可
修改配置文件，"outDir": "./"注释解开，具体目录地址可以自行设置

常用配置简版

{
  // ts编译器配置文件

  // 1、定义希望编译文件所在目录
  // ** 任意目录 * 任意文件
  "include": [
    "./src/**/*"
  ],

  // 2、定义需要排除在外的目录
  // 默认值 ["node_modules","bower_components","jspm_packages"]
  "exclude": [
    "./src/dyh/**/*"
  ],

  // 3、定义被继承的配置文件
  // "extends": "./configs/base",

  // 4、指定需要被编译的列表文件 -文件少使用
  // "files": [
  //   "sys.ts",
  //   "dyh.ts"
  // ],

  // 4、编译器选项
  "compilerOptions": {
    // 指定ts被编译的版本 <esnext> 最新版本
    "target": "ES5",

    // 指定要使用的模块化的规划 es2015,commonjs
    "module": "es2015",

    // 用来指定项目中使用的库 DOM等库  -不用设置
    // "lib": [],

    // 指定编译后文件所在目录
    "outDir": "./dist",

    // 将全局作用域代码合并为一个文件
    // "outFile": "./dist/app.js",

    // 是否对js文件进行编译，默认是false 不编译
    "allowJs": false,

    // 是否检测js代码是否符合规范
    "checkJs": false,

    // 是否移除注释
    "removeComments": false,

    // 不生成编译后的文件
    "noEmit": false,

    // 当有错误时不生成编译后的文件
    "noEmitOnError": false,
    
    // 所有严格检查的总开关
    "strict": false,

    // 设置编译后的文件是否使用严格模式
    "alwaysStrict": false,

    // 是否允许隐式的any类型
    "noImplicitAny": false,

    // 是否允许不明确类型的this
    "noImplicitThis": false,

    // 是否严格检查空值
    "strictNullChecks": false,

  },

}