带你入门Webpack及它能干什么？

Posted 2021-09-16 蛙人

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了带你入门Webpack及它能干什么？相关的知识，希望对你有一定的参考价值。

前言

初衷：本文我们讲一下Webpack，说说它能干什么及为什么要使用它。把我整理的笔记分享给大家，如有错误请各位指出，不喜勿喷。

适合人群：前端初级开发，大佬绕道。

本文讲解是Webpack4.x，注意版本。

为什么要使用Webpack

在之前我们都是用传统的方式去开发一个系统，html、css、js，就这些。开发完之后直接给后台人员去部署，当然这没什么问题。当我们的项目需求不断增加，代码也就越多，越不好维护，一个文件代码都上百甚至上千行，里面代码甚至都是重复的,还需要担心script标签依赖顺序问题，还需要担心代码变量污染问题，这时就出来了模块化，防止变量污染及依赖顺序问题，而现在主流打包工具就是Webpack，强大的社区支撑且支持Es Module、CommonJs、AMD规范。

什么是Webpack

Webpack是一个模块打包工具，可以将Es Module、CommonJs的语法处理成浏览器可以运行的代码，把文件相关联的依赖打包成一个js文件。

Webpack能干什么

利于我们便捷开发，帮助我们在本地搭建一个服务，代码变动热更新及不刷新页面，全局注入依赖文件，代码分割，代码提取，去除不必要的代码，区分环境变量，图片优化等，社区强大的插件扩展，帮助我们项目便捷开发。

安装

安装Webpack环境也非常的简单，一般情况下建议本地安装，全局安装可能会跟别的项目起冲突，尽量本地安装。

cnpm i webpack@4 webpack-cli --save

上面安装的webpack是语法，webpack-cli是命令行操作的执行命令

安装完之后，不能直接webpack -v这样会报错，因为它会去全局找你的webpack环境，但你现在是本地安装，使用npx webpack -v这样会在你项目进行本地查找。

快速上手

初始化package.json文件

在你的项目文件下执行该命令，进行对应填写(一路回车也可以)，傻瓜式操作。

npm init

项目结构

|- /node_modules
|- /src
   |- index.js
   |- news.js
   |- index.css
|- index.html
|- webpack.config.js
|- package.json

Entry

entry打包入口文件，打包入口有好几种形式，下面我们来一一介绍它们。

单入口

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

多入口

多入口打包，js文件名称则是对象的key值。

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

数组入口

数组打包，entry接收一个数组对象，里面参数只有最后一个值才是真正的打包路径，其它参数都是将本路径文件导入到最后一个参数里面

module.exports = {
    entry: ["./src/news.js", "./src/index.js"]
}

// 上面entry那种操作，等同于如下：
// index.js
require("news.js")

上面example中，除了最后一个参数，将其它数组参数都导入到最后一个参数文件内

Output

output有入口文件就得有出口文件，

module.exports = {
    output: {
        path: __dirname + "/dist",
        filname: "app.js"
    }
}

filename有几个名称选项，我来看介绍一下

[name] 使用入口文件名称
[chunkhash] 生成hash值，是通过当前文件所依赖的进行解析，最后生一个chunk，在生成hash值
[contenthash] 当文件内容改变值，hash值才会改变
[id] 使用chunk id生成文件名
[hash] 使用hash作为文件名称，每次生成的hash都不一样

module.exports = {
    output: {
        path: __dirname + "/dist",
        filname: "[name][id][contenthash].js"
    }
}

Loader

loader是什么，以上我们只说了js相关的，Webpack默认只认识js文件，那么Webpack怎么打包js之外的东西呢，打包js之外的就会报错，这怎么办呢，这时候使用loader，loader是一个转换器，我们下面以css文件为例子讲解

test 接收一个正则表达式，匹配文件后缀名称，匹配成功进入该loader执行
use 接收一个数组，当只有一个loader可以写成一个字符串

css-loader

安装

npm i css-loader --save-dev

使用

module.exports = {
     module: {
        rules: [
            {
                test: /\\.css$/,
                use: ["css-loader"] or "css-loader"
            }
        ]
    }
}

配置完该loader不会报错了，但是代码还是不生效。只是解析了css文件，并没有将style挂载到页面上，需要结合style-loader。

style-loader

安装

npm i style-loader --save-dev

使用

module.exports = {
     module: {
        rules: [
            {
                test: /\\.css$/,
                use: [
                    "style-loader",
                    "css-loader"
                ]
            }
        ]
    }
}

上面example中，loader必须有顺序执行，loader是从后往前执行的，先解析css文件，然后将解析完的css文件挂载到页面style标签上，这时在看代码就会生效。

Plugins

clean-webpack-plugin

这时如果我们把output里面的filename修改之后，再次打包，可以看到之前的dist包里面的旧代码还依然存在，这时我们想每次打包都生成一个新的dist目录，这时就需要用到插件了。

安装clean-webpack-plugin插件, 我本地安装是3.0.0的版本

npm i clean-wenpack-plugin --save-dev

使用

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

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

html-webpack-plugin

我们打包完dist目录下没有，index.html文件，那么我们可以使用该插件，在每次打包时都会生成一个html文件，下面我们来安装一下

安装html-webpack-plugin我这里使用的是3.2.0版本，需要注意的是，你本地的node版本越高，安装的插件越新，可能新版本会跟webpack4有点不兼容甚至导致代码报错。

npm i html-webpack-plugin@3.2.0 --save-dev

使用

const HtmlWebpackPlugin = require(\'html-webpack-plugin\')

module.exports = {
    plugins: [
        new HtmlWebpackPlugin({
            template: \'./index.html\',  // 以咱们本地的index.html文件为基础模板
            filename: "index.html",  // 输出到dist目录下的文件名称
        }),
    ]
}

html-webpack-plugin插件接收一个对象，这个对象有一些属性值，这里咱就不一一举例了，可以看这篇文章《html-webpack-plugin用法全解》。

完整代码

const { CleanWebpackPlugin } = require(\'clean-webpack-plugin\')
const HtmlWebpackPlugin = require(\'html-webpack-plugin\')

module.exports = {
    entry: "./src/index.js",
    output: {
        path: __dirname + "/dist",
        filename: "index.js"
    },
    module: {
        rules: [
            {
                test: /\\.css$/,
                use: [
                    "style-loader",
                    "css-loader"
                ]
            }
        ]
    },
    plugins: [
        new CleanWebpackPlugin(),
        new HtmlWebpackPlugin({
            template: \'./index.html\',
            filename: "index.html",
        }),
    ]
}