TS之编译配置

一般TS的编译配置都放在了compilerOptions中，官网，这里介绍几种常见的配置

target

官网，他所表示的是编译的js的版本

他后面跟一个字符串,表示编译的js版本，esnext表示es的最新版

{
  "compilerOptions": {
    "target": "esnext"
  }
}

他可以跟以下的值

lib

编译的时候引入ES的功能库 官网

module

官网，编译使用的模块化的方式

可选值有

目录相关

outDir

指定编译后的文件所在的目录，官网

outFile

非模块化的文件将被合并输出到一个文件中，官网

• module 是 None，System 或 AMD的时候才能有当前的配置
• 如果module是其他的配置的话，会报错

rootDir

• 声明根目录
• 编译的文件会以当前的目录为根目录

其他

1. removeComments
2. noEmit
3. sourceMap

严格检查

1. strict
2. alwaysStrict
3. noImplicitAny
4. noImplicitThis
5. strictBindCallApply
6. strictFunctionTypes
7. strictNullChecks
8. strictPropertyInitialization

其他检查

1. noFallthroughCasesInSwitch
2. noImplicitReturns
3. noUnusedLocals
4. noUnusedParameters

高级

1. allowUnreachableCode
2. noEmitOnError

汇总

{
	"incremental": true, // TS编译器在第一次编译之后会生成一个存储编译信息的文件，第二次编译会在第一次的基础上进行增量编译，可以提高编译的速度
	"tsBuildInfoFile": "./buildFile", // 增量编译文件的存储位置
	"diagnostics": true, // 打印诊断信息 
	"target": "ES5", // 目标语言的版本
	"module": "CommonJS", // 生成代码的模板标准
	                 // 默认值 target === "es3" or "es5" ?"commonjs" : "es6"
	"outFile": "./app.js", // 将多个相互依赖的文件生成一个文件，可以用在AMD模块中，
	                      // 即开启时应设置"module": "AMD",
	"lib": [], // 编译时引入的 ES 功能库，包括：es5 、es6、es7、dom 等。// 如果未设置，则默认为： target 为 es5 时: ["dom", "es5", "scripthost"] 
	//target 为 es6 时: ["dom", "es6", "dom.iterable", "scripthost"]
	"allowJS": true, // 允许编译器编译JS，JSX文件
	"checkJs": true, // 允许在JS文件中报错，通常与allowJS一起使用
	"outDir": "./dist", // 指定输出目录
	"rootDir": "./", // 指定输出文件目录(用于输出)，用于控制输出目录结构
	"declaration": true, // 生成声明文件，开启后会自动生成声明文件
	"declarationDir": "./file", // 指定生成声明文件存放目录
	"emitDeclarationOnly": true, // 只生成声明文件，而不会生成js文件
	"sourceMap": true, // 生成目标文件的sourceMap文件
	"inlineSourceMap": true, // 生成目标文件的inline SourceMap，//inline SourceMap会包含在生成的js文件中
	"declarationMap": true, // 为声明文件生成sourceMap
	"typeRoots": [], // 声明文件目录，默认时node_modules/@types
	"types": [], // 加载的声明文件包
	              //如果指定了某个值， 她会在 typeRoots 下找这个包，找到了就只加载这个包
	"removeComments":true, // 删除注释 
	"noEmit": true, // 不输出文件,即编译后不会生成任何js文件
	"noEmitOnError": true, // 发送错误时不输出任何文件
	"noEmitHelpers": true, // 不生成helper函数，减小体积，需要额外安装，常配合importHelpers一起使用
	"importHelpers": true, // 通过tslib引入helper函数，文件必须是模块
	"downlevelIteration": true, // 降级遍历器实现，如果目标源是es3/5，那么遍历器会有降级的实现
	"strict": true, // 开启所有严格的类型检查
	"alwaysStrict": true, // 在代码中注入'use strict'
	"noImplicitAny": true, // 不允许隐式的any类型
	"strictNullChecks": true, // 不允许把null、undefined赋值给其他类型的变量
	"strictFunctionTypes": true, // 不允许函数参数双向协变
	"strictPropertyInitialization": true, // 类的实例属性必须初始化
	"strictBindCallApply": true, // 严格的bind/call/apply检查
	"noImplicitThis": true, // 不允许this有隐式的any类型
	"noUnusedLocals": true, // 检查只声明、未使用的局部变量(只提示不报错)
	"noUnusedParameters": true, // 检查未使用的函数参数(只提示不报错)
	"noFallthroughCasesInSwitch": true, // 防止switch语句贯穿(即如果没有break语句后面不会执行)
	"noImplicitReturns": true, //每个分支都会有返回值
	"esModuleInterop": true, // 允许export=导出，由import from 导入
	"allowUmdGlobalAccess": true, // 允许在模块中全局变量的方式访问umd模块
	"moduleResolution": "node", // 模块解析策略，ts默认用node的解析策略，即相对的方式导入
	"baseUrl": "./", // 解析非相对模块的基地址，默认是当前目录
	"paths": { // 路径映射，相对于baseUrl
	    // 如使用jq时不想使用默认版本，而需要手动指定版本，可进行如下配置
	   "jquery": ["node_modules/jquery/dist/jquery.min.js"]
	  },
	"rootDirs": ["src","out"], // 将多个目录放在一个虚拟目录下，用于运行时，
	                          //即编译后引入文件的位置可能发生变化，
	                          //这也设置可以虚拟src和out在同一个目录下，不用再去改变路径也不会报错
	"listEmittedFiles": true, // 打印输出文件
	"listFiles": true , // 打印编译的文件(包括引用的声明文件)
	"jsx":"Preserve"   //在 .tsx 中支持 JSX ：React 或 Preserve
	"jsxFactory":""   //默认值 React.createElement	。  jsx 设置为 React 时使用的创建函数
}