TypeScript 快速入门

目录

第一章 快速入门

0、TypeScript简介

1、TypeScript 开发环境搭建

2、基本类型

3、编译选项

4、webpack

5、Babel

---

第一章 快速入门

0、TypeScript简介

TypeScript是JavaScript的超集。

它对JS进行了扩展，向JS中引入了类型的概念，并添加了许多新的特性。

TS代码需要通过编译器编译为JS，然后再交由JS解析器执行。

TS完全兼容JS，换言之，任何的JS代码都可以直接当成JS使用。

相较于JS而言，TS拥有了静态类型，更加严格的语法，更强大的功能；TS可以在代码执行前就完成代码的检查，减小了运行时异常的出现的几率；TS代码可以编译为任意版本的JS代码，可有效解决不同JS运行环境的兼容问题；同样的功能，TS的代码量要大于JS，但由于TS的代码结构更加清晰，变量类型更加明确，在后期代码的维护中TS却远远胜于JS。

1、TypeScript 开发环境搭建

安装解析 TS 的工具包

• 1. 打开 VSCode 终端。
• 2. 输入安装命令： npm i -g typescript 敲回车，来安装（注意：需要联网）。
• typescript：就是用来解析 TS 的工具包。提供了 tsc 命令，实现了 TS -> JS 的转化。

第一次使用ts-node命令报错

• 使用 npm uni -g ts-node 卸载掉ts-node
• 再使用 npm i -g [email protected]下载旧一点的版本就不会了

2、基本类型

• 类型声明
• 类型声明是TS非常重要的一个特点
• 通过类型声明可以指定TS中变量（参数、形参）的类型
• 指定类型后，当为变量赋值时，TS编译器会自动检查值是否符合类型声明，符合则赋值，否则报错
• 简而言之，类型声明给变量设置了类型，使得变量只能存储某种类型的值
• 语法：

let 变量: 类型;

let 变量: 类型 = 值;

function fn(参数: 类型, 参数: 类型): 类型{
    ...
}

------------------------------------
// 声明一个变量a指定他的类型为number
let a: number

// a 的值设置为了numbe 在以后的过程中a的值只能是number
a = 18
// a = 'hello' //此行代码会报错 因为变量a的类型为number
let b: string
b = 'hello'
// b = 1

//如果声明和赋值是同时进行的，ts会自动进行类型检测
let c = true
// c = 1


// // JS是不考虑参数类型和个数的
// function sum(a, b) {
//     return a + b
// }
// console.log(sum(123, "456"));


function sum(a: number, b: number): number {
    return a + 'hello'//返回值的类型应该为number
}
console.log(sum(123, "456", 666));//应该为两个参数

自动类型判断

• TS拥有自动的类型判断机制
• 当对变量的声明和赋值是同时进行的，TS编译器会自动判断变量的类型
• 所以如果你的变量的声明和赋值时同时进行的，可以省略掉类型声明

类型：

类型	例子	描述
number	1, -33, 2.5	任意数字
string	'hi', "hi", hi	任意字符串
boolean	true、false	布尔值true或false
字面量	其本身	限制变量的值就是该字面量的值
any	*	任意类型
unknown	*	类型安全的any
void	空值（undefined）	没有值（或undefined）
never	没有值	不能是任何值
object	{name:'孙悟空'}	任意的JS对象
array	[1,2,3]	任意JS数组
tuple	[4,5]	元素，TS新增类型，固定长度数组
enum	enum{A, B}	枚举，TS中新增类型

number

let decimal: number = 6;
let hex: number = 0xf00d;
let binary: number = 0b1010;
let octal: number = 0o744;
let big: bigint = 100n;

boolean

let isDone: boolean = false;

string

let color: string = "blue";
color = 'red';

let fullName: string = `Bob Bobbington`;
let age: number = 37;
let sentence: string = `Hello, my name is ${fullName}.

I'll be ${age + 1} years old next month.`;

字面量

也可以使用字面量去指定变量的类型，通过字面量可以确定变量的取值范围

let color: 'red' | 'blue' | 'black';
let num: 1 | 2 | 3 | 4 | 5;

any

let d: any = 4;
d = 'hello';
d = true;

unknown

let notSure: unknown = 4;
notSure = 'hello';

void

let unusable: void = undefined;

never

function error(message: string): never {
  throw new Error(message);
}

object（没啥用）

let obj: object = {};

array

let list: number[] = [1, 2, 3];
let list: Array = [1, 2, 3];

tuple

let x: [string, number];
x = ["hello", 10]; 

enum

enum Color {
  Red,
  Green,
  Blue,
}
let c: Color = Color.Green;

enum Color {
  Red = 1,
  Green,
  Blue,
}
let c: Color = Color.Green;

enum Color {
  Red = 1,
  Green = 2,
  Blue = 4,
}
let c: Color = Color.Green;

类型断言

有些情况下，变量的类型对于我们来说是很明确，但是TS编译器却并不清楚，此时，可以通过类型断言来告诉编译器变量的类型，断言有两种形式：

第一种

let someValue: unknown = "this is a string";
let strLength: number = (someValue as string).length;

第二种

et someValue: unknown = "this is a string";
let strLength: number = (someValue).length;

//也可以使用字面量进行赋值
let a: 10
// a = 11 //报错 不能将类型“11”分配给类型“10”。

//可以用 | 来链接多个类型
let color: 'red' | 'blue'
color = "red"
color = 'blue'

let c: boolean | string
c = true
c = 'hello'

//any 表示任意类型，一个变量设置类型为any后，相当于对该变量关闭了语法检测
// 使用ts时不建议使用any
// let d: any

// 声明变量不指定类型,则ts解析器会自动判断变量类型为any (隐式any)
let d
d = 10
d = 'aa'
d = true

// unknown实际上是一个类型安全的any
// unknown类型的变量不能赋值给其他变量
let e: unknown
e = 'aa'

let s: string
// d的类型是any他可以赋值给任意变量
s = d


s = e //不能将类型“unknown”分配给类型“string”。
if (typeof e === 'string') {
    s = e
}

//类型断言，可以用来告诉解析器变量的实际类型
s = e as string //变量as类型
s = e//<类型>变量

//void 用来表示空 以函数为例，就是没有返回值的函数
function fn(): void { }

//never 表示永远不会返回结果
function fn1(): never {
    throw new Error('报错了')
}

// object 表示一个对象
let a: object
a = {}
a = function () { }
//{}用来指定可以包含那些内容
// 语法{属性名：属性值}
//属性名后面加上？表示可选属性
let b: { name: string, age?: number }
b = { name: '孙悟空' }
// [xx: string]: any 表示任意类型的属性
let c: { name: string, [xx: string]: any }
c = { name: '猪八戒', age: 18, gender: "男" }

//设置函数的结构的类型声明
// 语法(形参：类型)=>返回值
let d: (a: number, b: number) => number
d = function (n1: number, b: number): number {
    return 10
}

//表示字符串数组
let e: string[]  //类型[]
e = ["a", "b"]

let g: Array //array<>
g = [1, 2]

//元祖：元祖就是固定长度的数组
let h: [string, string] //[类型]
h = ['a', 'b']

// enum枚举
enum Gender {
    male = 1,
    Female = 0
}
let i: { name: string, gender: Gender }
i = {
    name: '孙悟空',
    gender: Gender.Female
}
console.log(i.gender === Gender.Female);
// & 表示同时
let j: { name: string } & { age: number }
j = { name: '孙悟空', age: 18 }

//类型的别名
type myType = 1 | 2 | 3
let k: myType

3、编译选项

自动编译文件

编译文件时，使用 -w 指令后，TS编译器会自动监视文件的变化，并在文件发生变化时对文件进行重新编译。

示例：

tsc xxx.ts -w

自动编译整个项目

• 如果直接使用tsc指令，则可以自动将当前项目下的所有ts文件编译为js文件。
• 但是能直接使用tsc命令的前提时，要先在项目根目录下创建一个ts的配置文件 tsconfig.json
• tsconfig.json是一个JSON文件，添加配置文件后，只需只需 tsc 命令即可完成对整个项目的编译

配置选项：

• include
• 定义希望被编译文件所在的目录
• 默认值：["**/*"]
• 示例：

"include":["src/**/*", "tests/**/*"]

上述示例中，所有src目录和tests目录下的文件都会被编译

exclude

• 定义需要排除在外的目录
• 默认值：["node_modules", "bower_components", "jspm_packages"]
• 示例：

"exclude": ["./src/hello/**/*"]

上述示例中，src下hello目录下的文件都不会被编译

extends

定义被继承的配置文件

示例：

"extends": "./configs/base"

上述示例中，当前配置文件中会自动包含config目录下base.json中的所有配置信息

files

• 指定被编译文件的列表，只有需要编译的文件少时才会用到
• 示例：

"files": [
    "core.ts",
    "sys.ts",
    "types.ts",
    "scanner.ts",
    "parser.ts",
    "utilities.ts",
    "binder.ts",
    "checker.ts",
    "tsc.ts"
  ]

列表中的文件都会被TS编译器所编译

compilerOptions

• 编译选项是配置文件中非常重要也比较复杂的配置选项
• 在compilerOptions中包含多个子选项，用来完成对编译的配置

项目选项

target

• 设置ts代码编译的目标版本
• 可选值：
• ES3（默认）、ES5、ES6/ES2015、ES7/ES2016、ES2017、ES2018、ES2019、ES2020、ESNext
• 示例：

"compilerOptions": { "target": "ES6" }

如上设置，我们所编写的ts代码将会被编译为ES6版本的js代码

lib

• 指定代码运行时所包含的库（宿主环境）
• 可选值：
• ES5、ES6/ES2015、ES7/ES2016、ES2017、ES2018、ES2019、ES2020、ESNext、DOM、WebWorker、ScriptHost ......
• 示例：

"compilerOptions": {
    "target": "ES6",
    "lib": ["ES6", "DOM"],
    "outDir": "dist",
    "outFile": "dist/aa.js"
}

module

• 设置编译后代码使用的模块化系统
• 可选值：
• CommonJS、UMD、AMD、System、ES2020、ESNext、None
• 示例：

"compilerOptions": {
    "module": "CommonJS"
}

outDir

• 编译后文件的所在目录
• 默认情况下，编译后的js文件会和ts文件位于相同的目录，设置outDir后可以改变编译后文件的位置
• 示例：

"compilerOptions": {
    "outDir": "dist"
}

设置后编译后的js文件将会生成到dist目录

outFile

• 将所有的文件编译为一个js文件
• 默认会将所有的编写在全局作用域中的代码合并为一个js文件，如果module制定了None、System或AMD则会将模块一起合并到文件之中
• 示例：

"compilerOptions": {
    "outFile": "dist/app.js"
}

rootDir

• 指定代码的根目录，默认情况下编译后文件的目录结构会以最长的公共目录为根目录，通过rootDir可以手动指定根目录
• 示例：

"compilerOptions": { "rootDir": "./src" }

allowJs

• 是否对js文件编译

checkJs

• 是否对js文件进行检查
• 示例：

"compilerOptions": { "allowJs": true, "checkJs": true }

removeComments

• 是否删除注释
• 默认值：false

noEmit

• 不对代码进行编译
• 默认值：false

sourceMap

• 是否生成sourceMap
• 默认值：false

严格检查

• strict 启用所有的严格检查，默认值为true，设置后相当于开启了所有的严格检查
• alwaysStrict 总是以严格模式对代码进行编译
• noImplicitAn 禁止隐式的any类型
• noImplicitThis 禁止类型不明确的this
• strictBindCallApply 严格检查bind、call和apply的参数列表
• strictFunctionTypes 严格检查函数的类型
• strictNullChecks 严格的空值检查
• strictPropertyInitialization 严格检查属性是否初始化

额外检查

• noFallthroughCasesInSwitch 检查switch语句包含正确的break
• noImplicitReturns 检查函数没有隐式的返回值
• noUnusedLocals 检查未使用的局部变量
• noUnusedParameters 检查未使用的参数

高级

allowUnreachableCode 检查不可达代码

可选值：

• true，忽略不可达代码
• false，不可达代码将引起错误

noEmitOnError

• 有错误的情况下不进行编译
• 默认值：false

{
    /* tsconfig.json 是ts 编译器的配置文件 ，ts编译器可以根据他的信息来对代码进行编译
    include用来指定那些ts文件需要被编译
        路径 **表示任意目录
             *表示任意文件  
    */
    "include": [
        "src/**/*"
    ],
    // "exclude": [
    //     "./src/hello/**/*"
    // ]

    /* compilerOptions 编译器的选项 */
    "compilerOptions": {

        // target 用来指定ts被编译为的ES版本 
        //"ES3", "ES5", "ES6", "ES2015", "ES2016", "ES2017", "ES2018", "ES2019", "ES2020", "ES2021", "ES2022", "ESNext".
        "target": "ES6",

        //module 指定模块化的规范
        // 'none', 'commonjs', 'amd', 'system', 'umd', 'es6', 'es2015', 'es2020', 'es2022', 'esnext', 'node12', 'nodenext'。
        "module": "es2015",
        
        //用来指定要使用的库
        // "ES5", "ES6", "ES2015", "ES2015.Collection", "ES2015.Core", "ES2015.Generator", "ES2015.Iterable", "ES2015.Promise", ...

        // "lib": ["aa"]

        //用来指定编译后的文件存放目录
        "outDir": "./dist",

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

        //是否对js文件进行编译
        "allowJs": true,
        //是否检测js代码是否符合语法规范
        "checkJs": true,
        //是否移除注释
        "removeComments": true,
        //不生成编译后的文件
        "noEmit": false,
        //当有错误的时候不生成编译文件
        "noEmitOnError": false,

        //用来设置编译后的文件是否使用严格模式
        "alwaysStrict": true,
        
        //不允许使用隐式的any
        "noImplicitAny": true,

        //不允许不明确类型的this
        "noImplicitThis": true,
        
        //严格的检查空值
        "strictNullChecks": true,

        //所有严格检查的总开关
        "strict": true
    }
    
}

4、webpack

通常情况下，实际开发中我们都需要使用构建工具对代码进行打包，TS同样也可以结合构建工具一起使用，下边以webpack为例介绍一下如何结合构建工具使用TS。

步骤：

• 初始化项目
• 进入项目根目录，执行命令 npm init -y
• 主要作用：创建package.json文件

下载构建工具

npm i -D webpack webpack-cli webpack-dev-server typescript ts-loader clean-webpack-plugin

共安装了7个包

• webpack 构建工具webpack
• webpack-cli webpack的命令行工具
• webpack-dev-server webpack的开发服务器
• typescript ts编译器
• ts-loader ts加载器，用于在webpack中编译ts文件
• html-webpack-plugin webpack中html插件，用来自动创建html文件
• clean-webpack-plugin webpack中的清除插件，每次构建都会先清除目录

根目录下创建webpack的配置文件webpack.config.js

const path = require('path');
//自动创建html
const HtmlWebpackPlugin = require('html-webpack-plugin');
// 清除文件
const { CleanWebpackPlugin } = require("clean-webpack-plugin");

//webpack配置信息都应该写在 module.exports 中
module.exports = {
    //指定入口文件
    entry: './src/index.ts',
    //打包文件所在的目录
    output: {
        path: path.resolve(__dirname, 'dist'),
        // 打包后文件的名字
        filename: 'bundle.js',
        //告诉webpack不使用箭头函数
        enviroument:{
            arrowFunction:false
        }

    },

    // 指定webpack打包时使用的模块
    module: {
        //指定加载规则
        rules: [
            {
                //指定规则生效的文件
                test: /\.ts$/,
                //要使用的loader
                use: 'ts-loader',
                //要排除的文件
                exclude: /node_modules/
            }
        ]
    },

    //配置webpack插件
    plugins: [
        new CleanWebpackPlugin(),
        new HtmlWebpackPlugin({
            // title: '自定义'
            template: './src/index.html'
        })
    ],

    //用来设置引用模块
    resolve: {
        extensions: ['.ts', '.js']
    }
}

根目录下创建tsconfig.json，配置可以根据自己需要

{
    "compilerOptions": {
        "target": "ES2015",
        "module": "ES2015",
        "strict": true
    }
}

修改package.json添加如下配置

{
  ...略...
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "webpack",
    "start": "webpack serve --open chrome.exe"
  },
  ...略...
}

在src下创建ts文件，并在并命令行执行npm run build对代码进行编译，或者执行npm start来启动开发服务器

5、Babel

经过一系列的配置，使得TS和webpack已经结合到了一起，除了webpack，开发中还经常需要结合babel来对代码进行转换以使其可以兼容到更多的浏览器，在上述步骤的基础上，通过以下步骤再将babel引入到项目中。

安装依赖包：

npm i -D @babel/core @babel/preset-env babel-loader core-js

共安装了4个包，分别是：

• @babel/core babel的核心工具
• @babel/preset-env babel的预定义环境
• @babel-loader babel在webpack中的加载器
• core-js core-js用来使老版本的浏览器支持新版ES语法
• 修改webpack.config.js配置文件

...略...
module: {
    rules: [
        {
            //指定规则生效文件
            test: /\.ts$/,
            //要使用的loader
            use: [
               //配置loder
                {
                    //指定加载器
                    loader: "babel-loader",
                    //设置babel
                    options:{
                        //设置预定义的环境
                        presets: [
                            [
                                //指定环境插件
                                "@babel/preset-env",
                                 //配置信息
                                {
                                   浏览器兼容版本
                                    "targets":{
                                        "chrome": "58",
                                        "ie": "11"
                                    },
                                    //指定corejs的版本
                                    "corejs":"3",
                                      //使用corejs的方式为usage按需加载
                                    "useBuiltIns": "usage"
                                }
                            ]
                        ]
                    }
                },
                {
                    loader: "ts-loader",

                }
            ],
            exclude: /node_modules/
        }
    ]
}
...略...

如此一来，使用ts编译后的文件将会再次被babel处理，使得代码可以在大部分浏览器中直接使用，可以在配置选项的targets中指定要兼容的浏览器版本。