自学 TypeScript 第三天使用webpack打包 TS 代码

来源：cnblogs　　作者：六扇有伊人　　时间：2022/11/19 17:14:44　　对本文有异议

前言：

大家好啊，昨天介绍了 TS 编译器的配置，但在我们实际开发当中直接使用 TS 编译器去编译代码的情况会有，但没有很多，因为我们在开发大型项目的时候，一般我们都会用到打包工具，也不可能脱离打包工具去使用 TS

所以我们的 TS 在大多数情况下都是结合着打包工具去使用的，比如webpack，vite...

而今天我们就学习如何用 webpack 打包我们的 TS 代码

安装：

首先第一步，我们要初始化我们项目，在目录下输入

npm init

接下来，我们的安装几个工具

npm i -D webpack webpack-cli typescript ts-loader

-D 意思是开发依赖，也就是我们现在所安装的依赖都是开发依赖，完整应该是 -dev -server 我们直接用 -D 简写

webpack 就是我们打包工具的一个核心代码

webpack-cli 是 webpack 的命令行工具，装了以后我们可以通过命令行去使用

typescript 是 TS 的核心包

ts-loader 是 TS 的加载器，通过 ts-loader 可以让 webpack 和 TS 进行整合，让他们成为一体的

下载成功之后，恭喜你，一个基础的架子这就搭好了

接下来，和六扇老师一起，让我们简单的做一个基础配置吧

基础配置：

下载完成之后，我们可以看到我们的项目里多了一个 node_modules 的文件夹，那是一些依赖不用去管

接下来在我们项目的根目录里创建一个名为 webpack.config.js 的文件，以及一个 tsconfig.json 的文件

用来配置我们的 webpack 和 TS ，目录结构如下

打开 webpack.config.js 进行配置

第一步，我们先引用一个 path 包用来拼接路径

const paht = require('path')

第二步，写一个 module.exports 的对象，webpack 中所有的配置信息都应该写到我们的 module.exports 里

第三步，写一个 entry : " " ，

module.exports = {
    entry:"./src/index.ts",
}

意思是入口文件，就是指定打包文件位置

第四步，output ：{ }，里面有俩个属性一个是 path 一个是 filename 以及 environment

module.exports = {
    output:{
        path:path.resolve(__dirname,'dist'),
        filename:"bundle.js",

　　　　　environment:{
　　　　　　arrowFunction:false,
　　　　　}

    },
}

path 的意思是打包完成之后文件存放的位置

ffliename 打包之后的文件叫什么

environment： arrowFunction 告诉 webpack 别使用箭头函数了

第五步，module 对象，指定打包时候要用的模块

module.exports = {
    module:{
        rules:[
            {
                test:/\.ts$/, 
                use:'ts-loader',
                exclude:/node-modules/,
            }
        ]
    }
}

里面有一个 rules 数组用来指定加载规则，里面接对象

test ：正则，指定规则生效的文件，/\.ts$/ ：所有以 ts 结尾的文件

use：指定要用的 loader

exclude ：要排除哪些文件

webpack.config.js 全部代码：

// 引入一个包
const path = require('path'); // 用户拼接路径
 
// webpack 中所有的配置信息都应该写到我们的 module.exports 里
module.exports = {
    // 指定入口文件
    entry:"./src/index.ts",
    // 指定打包文件所在的目录
    output:{
        path:path.resolve(__dirname,'dist'),
        // 打包后文件的文件
        filename:"bundle.js",
　　　　 // 告诉 webpack 不使用箭头函数
　　　　　environment:{
　　　　　　arrowFunction:false,
　　　　　}
    },
    // 指定webpack 打包时要使用的模块
    module:{
        // 指定加载的规则
        rules:[
            {
                // test 指定的是规则生效的文件
                test:/\.ts$/, // 所有以 ts 结尾的文件
                use:'ts-loader',
                // 要排除的文件
                exclude:/node-modules/,
            }
        ]
    }
}

这样一个基础的 webpack.config.js 配置就完成了

下面进行一个 taconfig.json 的配置，非常简单

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

规定，所有规则为 ES2015,也就 ES6 规范，然后 strict 为 true 开启最严格模式

然后还有最后一件事在我们的 package.json 里面 scripts 里面添加一个命令

什么意思呢，就是通过 bukud 命令来执行我们的 webpack

经过这一系列步骤，我们的 webpack 和 TS 一个最基本的组合这就成型了，然后我们就可以在命令行中输入

npm run build

之后我们看见，项目下出现 dist 目录，里面有一个 bundle.js 就证明我们成功了

如果之前学过 webpack 的可以不用看了，因为往下都是关于 webpack 的配置了

进阶webpack打包：

我们打包完成之后，有了一个单独的 JS 文件，但问题来了，怎么使用呢？

这时有同学说了，六扇老师我直接创建一个 index.html 文件，然后 srcipt src 引入不行吗？

可以是可以，但是，很麻烦，而且将来文件发生变化，或添加别的 JS 文件还要手动的去改

那怎么做呢，这时就需要 webpack 的一个插件了

第一步，下载 html-webpack-plugin

npm i -D -S html-webpack-plugin

什么意思呢，就是自动的帮助我们生成 html 文件

第二步，在 webpack.config.js 引入我们的 html 插件

const HTMLWebpackPlugin = require('html-webpack-plugin');

第三步，在 module.exports 里面写一个 plugins 属性用来配置 webpack 插件

module.exports = {
    plugins:[
        new HTMLWebpackPlugin(),
    ]
}

然后我们再执行打包命令，在我们的 dist 文件下就会自动生成一个 index.html 文件

当然我们也可以给生成的 html 文件一个 html 模板，用 template 方法

module.exports = {
    plugins:[
        new HTMLWebpackPlugin({
            template:'./src/index.html',
        })
    ]
}

意思就是打包之后生成 index 继承 src 下的 html 所生成的模板

第二个插件，webpack 的开发服务器，就相当于在我们的项目里面安装了一个内置的服务器

可以让我们的项目在这个服务器里直接运行，而这个服务器是跟随我们项目有关联的，它会跟随我们的项目进行改动，自动去刷新

npm i -D -S webpack-dev-server

下载成功之后，我们在 package.json 文件里面，刚才设置 build 的下边设置一个 start

"start": "webpack serve --open chrome.exe"

然后在命令行输入

npm start

就会自动打开浏览器了

第三个插件，每一个编译前，清空我们的 dist 目录，然后把新文件放进去，避免旧文件残留

npm i -D -S clean-webpack-plugin

和html-webpack-plugin 一样，直接引用 clean-webpack-plugin

const { CleanWebpackPlugin } = require('clean-webpack-plugin');

然后在 plugins 里面配置，直接加在 new HTMLWebpackPlugin 下边或上边就行

module.exports = {
    plugins:[
        new CleanWebpackPlugin(),
        new HTMLWebpackPlugin({
            template:'./src/index.html',
        })
    ]
}

好了，这样就 ok 了，看不出什么效果，没报错就成功了

第四个配置，在我们编写 TS 引入其他 TS 文件的时候，webpack 不知道我们的 TS 文件可以当作一个模块去引用的，所以会报错

这时候我们必须做一个配置，告诉 webpack 哪些文件可以当作一个模块引入

直接配置，在 webpack.config.js 里写一个 resolve 用来设置引用模块

module.exports = {
    resolve:{
        extensions:['.ts','.js'] 
    }
}

设置 extensions 告诉 webpack 以 .ts 和 .js 结尾的都可以当模块去引用

到这里，如果我们不考虑一些兼容性的问题，所以都必要配置都已经引用好了，多敲几遍，熟悉几遍

兼容性：

我们在写代码的时候都会考虑一个兼容性的问题，ES5啊，ES6啊，比如我们的老浏览器 IE 就不支持新 ES6 语法，这时候我们就需要把代码转成其他版本的

而我们的 webpack 也不例外，那如何让我们打包之后的代码自动转换兼容呢，这时候就要引用一个工具了 --babel

废话不多说，我们首先一步我们直接在我们的项目里下载 babel

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

@babel/core ：我们 babel 的一个核心工具

@babel/preset-env ：preset 预先设置的，env 环境，里面预置不同的环境

babel-loader ：loader 包用来结合的

core-js ： js 一个运行环境，可以让我们的老浏览器用到新浏览的语法，技术

下载完成之后，我们可以去 package.json 看一下，看看是否加载成功

第二步，确认无误之后，我们再打开我们的 webpack.config.js 文件进行配置

找到我们之前配置的 module 里面不是有我们之前配置的 use ：ts-loader 使用 loader 包，这时再添加一个就行了

module.exports = {
    module:{
        rules:[
            {
                test:/\.ts$/, 
                use:[
                    'babel-loader',
                    'ts-loader',
                ],    
            },
          ],   
　　} 
}

当然我们还可以进行详细的配置，推荐：

    module:{
        // 指定加载的规则
        rules:[
            {
                // test 指定的是规则生效的文件
                test:/\.ts$/, // 所有以 ts 结尾的文件
                // use:'ts-loader',
                use:[
                    // 配置我们的 babel
                    {
                        //  指定我们的加载器
                        loader:"babel-loader",
                        // 配置我们的babel
                        options:{
                            // 设置预定的环境
                            presets:[
                                [
                                    // 指定我们的环境插件
                                    "@babel/preset-env",
                                    // 配置信息
                                    {
                                        // 要兼容的目标浏览器
                                        targets:{
                                            "chrome":"88" // 指定浏览器的一个版本
                                        },
                                        // 指定 corejs 版本
                                        "corejs":"3", // 用那个版本的 js
                                        // 使用 corejs 的方式
                                        "useBuiltIns":"usage", // usage 按需加载
                                    }
                                ]
                            ]
                        },
                    },
                    'ts-loader',
                ],
                // 要排除的文件
                exclude:/node-modules/,
            }
        ]
    },

use执行的时候，会优先执行下边的，所以记得把 ts-loader 放在下边，因为我们想先让 ts 转换然后再兼容转换

loader：指定我们的加载器

options：{ } 里面的 presets 是预设我们的环境语法：

options：{

presets ：[

[

"@babel/preset-env", 第一个值，来指定我们的环境插件是那个，

{

targets：{} 设置我们的要兼容的浏览器是哪些， ”浏览器名字“ : "版本"

}

"corejs" : "3" 指定 corejs 版本

”useBuiltIns“ ："usage" 使用方式按需加载

]

}

好了，这样我们所有的 webpack 都配置好了，打包看看能不能使用

到此为止，我们的 TS 加 webpack 以及 babel 就都配置好了，最后贴出配置完成所有 webpack.config.js 代码

// 引入一个包
const path = require('path'); // 用户拼接路径
 
// 引入 html 插件
const HTMLWebpackPlugin = require('html-webpack-plugin');
// 引入 clean 插件
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 打包时要使用的模块
    module:{
        // 指定加载的规则
        rules:[
            {
                // test 指定的是规则生效的文件
                test:/\.ts$/, // 所有以 ts 结尾的文件
                // use:'ts-loader',
                use:[
                    // 配置我们的 babel
                    {
                        //  指定我们的加载器
                        loader:"babel-loader",
                        // 配置我们的babel
                        options:{
                            // 设置预定的环境
                            presets:[
                                [
                                    // 指定我们的环境插件
                                    "@babel/preset-env",
                                    // 配置信息
                                    {
                                        // 要兼容的目标浏览器
                                        targets:{
                                            "chrome":"58",
                                            "ie":"11" // 指定浏览器的一个版本
                                        },
                                        // 指定 corejs 版本
                                        "corejs":"3", // 用那个版本的 js
                                        // 使用 corejs 的方式
                                        "useBuiltIns":"usage", // usage 按需加载
                                    }
                                ]
                            ]
                        },
                    },
                    'ts-loader',
                ],
                // 要排除的文件
                exclude:/node-modules/,
            }
        ]
    },
    // 配置 webpack 插件
    plugins:[
        new CleanWebpackPlugin(),
        new HTMLWebpackPlugin({
            template:'./src/index.html',
        })
    ],
    
    // 用来设置引用模块
    resolve:{
        extensions:['.ts','.js'] // 以 .ts 和 .js 结尾的都可以当模块去引用
    }
}