webpack4-用之初体验,一起敲它十一遍

众所周知,webpack进入第4个大版本已经有2个月的时间了,而且webpack团队升级更新的速度也是非常的惊人
在写下如下内容的时候webpack已经出到了4.6的版本了,剑指5.0应该是指日可待了,当然这些都是个人的臆想,并不代表任何意见
既然我们已经迎接了webpack4的到来了,那么就一起来使用一下,即使你没用过之前的版本,没关系,我们重新出发,将工作中常用到的配置写给大家来看
非友情提示:由于webpack使用起来并不能仅看代码就方便理解,所以有图有真相的才是正解,于是乎本文配图很多,真的是很多
首先,既来之,则安之

安装webpack

  • 需要先在项目中npm init初始化一下,生成package.json
  • 建议node版本安装到8.2以上

    1. // webpack4中除了正常安装webpack之外,需要再单独安一个webpack-cli
    2. npm i webpack webpack-cli -D
    3. 复制代码

    ★ npm i -D 是 npm install —save-dev 的简写,是指安装模块并保存到 package.json 的 devDependencies中,主要在开发环境中的依赖包

    0配置了什么

    webpack4可以支持0配置打包,这里所说的0配置又是什么呢?当然在开发者眼中0配置的东西,那根本是无法用的,因为不够智能,那么我们就来看看做到了哪些0配置
    在使用webpack进行打包的时候,默认情况下会将src下的入口文件(index.js)进行打包

    1. // node v8.2版本以后都会有一个npx
    2. // npx会执行bin里的文件
    3. npx webpack // 不设置mode的情况下 打包出来的文件自动压缩
    4. npx webpack --mode development // 设置mode为开发模式,打包后的文件不被压缩
    5. 复制代码

    当执行npx webpack命令的时候,webpack会自动查找项目中src目录下的index.js文件,然后进行打包,生成一个dist目录并存在一个打包好的main.js文件
    这些算是0配置的操作了,名字都是定义好的,不能变,想想也很鸡肋
    webpack4 - 图1webpack4 - 图2webpack的使用还是在我们的配置方面,下面就进入我们的常规操作环节

    webpack是基于Node的

    在项目下创建一个webpack.config.js(默认,可修改)文件来配置webpack

    1. module.exports = {
    2. entry: '', // 入口文件
    3. output: {}, // 出口文件
    4. module: {}, // 处理对应模块
    5. plugins: [], // 对应的插件
    6. devServer: {}, // 开发服务器配置
    7. mode: 'development' // 模式配置
    8. }
    9. 复制代码

    以上就是webpack的正常配置模块
    ★ 启动devServer需要安装一下webpack-dev-server

    1. npm i webpack-dev-server -D
    2. 复制代码

    webpack4 - 图3按照项目的结构,我们就从0开始去写一下配置吧

    1. // webpack.config.js
    2. const path = require('path');
    3. module.exports = {
    4. entry: './src/index.js', // 入口文件
    5. output: {
    6. filename: 'bundle.js', // 打包后的文件名称
    7. path: path.resolve('dist') // 打包后的目录,必须是绝对路径
    8. }
    9. }
    10. 复制代码

    上面就可以说是实现了最简单的webpack配置了,那接下来就打包一下看看
    webpack4 - 图4

    配置执行文件

    工作当中我们打包编译的时候一般都执行npm run dev这样的命令,既然是通过npm执行的命令,我们就应该找到package.json里的执行脚本去配置一下命令,这里如下图所示
    webpack4 - 图5npm run build就是我们打包后的文件,这是生产环境下,上线需要的文件
    npm run dev是我们开发环境下打包的文件,当然由于devServer帮我们把文件放到内存中了,所以并不会输出打包后的dist文件夹
    通过npm run build之后会生成一个dist目录文件夹,就和上面打包后的样子一样了

    多入口文件

    多个入口可以有两种实现方式进行打包

  • 一种是没有关系的但是要打包到一起去的,可以写一个数组,实现多个文件打包

  • 另一种就是每一个文件都单独打包成一个文件的
  • 下面就来看看这两种方式的写法

    1. let path = require('path');
    2. module.exports = {
    3. // 1.写成数组的方式就可以打出多入口文件,不过这里打包后的文件都合成了一个
    4. // entry: ['./src/index.js', './src/login.js'],
    5. // 2.真正实现多入口和多出口需要写成对象的方式
    6. entry: {
    7. index: './src/index.js',
    8. login: './src/login.js'
    9. },
    10. output: {
    11. // 1. filename: 'bundle.js',
    12. // 2. [name]就可以将出口文件名和入口文件名一一对应
    13. filename: '[name].js', // 打包后会生成index.js和login.js文件
    14. path: path.resolve('dist')
    15. }
    16. }
    17. 复制代码

    这时候执行npm run build后,会生成打包好的两个js文件,如图所示
    webpack4 - 图6

    配置Html模板

    文件都打包好了,但是我们在使用的时候不能在dist目录下去创建一个html文件,然后去引用打包后的js吧,这不合理,实际开发中也不会这样
    我们需要实现html打包功能,可以通过一个模板实现打包出引用好路径的html来
    这就需要用到一个常用的插件了,html-webpack-plugin,用之前我们来安一下它

    1. npm i html-webpack-plugin -D
    2. 复制代码

    因为是个插件,所以需要在config.js里引用一下的

    1. let path = require('path');
    2. // 插件都是一个类,所以我们命名的时候尽量用大写开头
    3. let HtmlWebpackPlugin = require('html-webpack-plugin');
    4. module.exports = {
    5. entry: './src/index.js',
    6. output: {
    7. // 添加hash可以防止文件缓存,每次都会生成4位的hash串
    8. filename: 'bundle.[hash:4].js',
    9. path: path.resolve('dist')
    10. },
    11. plugins: [
    12. // 通过new一下这个类来使用插件
    13. new HtmlWebpackPlugin({
    14. // 用哪个html作为模板
    15. // 在src目录下创建一个index.html页面当做模板来用
    16. template: './src/index.html',
    17. hash: true, // 会在打包好的bundle.js后面加上hash串
    18. })
    19. ]
    20. }
    21. 复制代码

    通过上面的配置后,我们再npm run build打包看一下现在是个什么样子了
    webpack4 - 图7

    多页面开发,怎么配置多页面

    如果开发的时候不只一个页面,我们需要配置多页面,那么需要怎么来搞呢?不用担心,html-webpack-plugin插件自有办法,我们来观望一下

    1. let path = require('path');
    2. let HtmlWebpackPlugin = require('html-webpack-plugin');
    3. module.exports = {
    4. // 多页面开发,怎么配置多页面
    5. entry: {
    6. index: './src/index.js',
    7. login: './src/login.js'
    8. },
    9. // 出口文件
    10. output: {
    11. filename: '[name].js',
    12. path: path.resolve('dist')
    13. },
    14. plugins: [
    15. new HtmlWebpackPlugin({
    16. template: './src/index.html',
    17. filename: 'index.html',
    18. chunks: ['index'] // 对应关系,index.js对应的是index.html
    19. }),
    20. new HtmlWebpackPlugin({
    21. template: './src/login.html',
    22. filename: 'login.html',
    23. chunks: ['login'] // 对应关系,login.js对应的是login.html
    24. })
    25. ]
    26. }
    27. 复制代码

    继续npm run build看打包后的样子
    webpack4 - 图8上面基本介绍完了html和js的打包配置了,现在我们还缺一个好兄弟css,webpack对css的解析需要用到loader,所以我们先提前安装好,待会好方便使用

    引用CSS文件

    可以在src/index.js里引入css文件,到时候直接打包到生产目录下
    需要下载一些解析css样式的loader

    1. npm i style-loader css-loader -D
    2. // 引入less文件的话,也需要安装对应的loader
    3. npm i less less-loader -D
    4. 复制代码

    下面我们来看一下如何配置css文件的解析

    1. // index.js
    2. import './css/style.css'; // 引入css
    3. import './less/style.less'; // 引入less
    4. console.log('这里是打包文件入口-index.js');
    5. // webpack.config.js
    6. module.exports = {
    7. entry: {
    8. index: './src/index.js'
    9. },
    10. output: {
    11. filename: 'bundle.js',
    12. path: path.resolve('dist')
    13. },
    14. module: {
    15. rules: [
    16. {
    17. test: /\.css$/, // 解析css
    18. use: ['style-loader', 'css-loader'] // 从右向左解析
    19. /*
    20. 也可以这样写,这种方式方便写一些配置参数
    21. use: [
    22. {loader: 'style-loader'},
    23. {loader: 'css-loader'}
    24. ]
    25. */
    26. }
    27. ]
    28. }
    29. }
    30. 复制代码

    webpack4 - 图9

  • 此时打包后的css文件是以行内样式style的标签写进打包后的html页面中,如果样式很多的话,我们更希望直接用link的方式引入进去,这时候需要把css拆分出来

  • extract-text-webpack-plugin插件相信用过的人都知道它是干什么的,它的功效就在于会将打包到js里的css文件进行一个拆分

    拆分CSS

    1. // @next表示可以支持webpack4版本的插件
    2. npm i extract-text-webpack-plugin@next -D
    3. 复制代码
    1. let path = require('path');
    2. let HtmlWebpackPlugin = require('html-webpack-plugin');
    3. // 拆分css样式的插件
    4. let ExtractTextWebpackPlugin = require('extract-text-webpack-plugin');
    5. module.exports = {
    6. entry: './src/index.js',
    7. output: {
    8. filaneme: 'bundle.js',
    9. path: path.resolve('dist')
    10. },
    11. module: {
    12. rules: [
    13. {
    14. test: /\.css$/,
    15. use: ExtractTextWebpackPlugin.extract({
    16. // 将css用link的方式引入就不再需要style-loader了
    17. use: 'css-loader'
    18. })
    19. }
    20. ]
    21. },
    22. plugins: [
    23. new HtmlWebpackPlugin({
    24. template: './src/index.html',
    25. }),
    26. // 拆分后会把css文件放到dist目录下的css/style.css
    27. new ExtractTextWebpackPlugin('css/style.css')
    28. ]
    29. }
    30. 复制代码

    此时拆分完css后,打包的html页面就以link的方式去引入css了,这样很好
    webpack4 - 图10当然大家很多都说另外一个插件也是可以办到的,那就是mini-css-extract-plugin,是的可以说它是为webpack4而生的,而之所以上来就没有介绍是因为还不成熟,还有很多bug需要去解决的
    不过既然大家都知道它,那就顺便也提一下吧

    1. npm i mini-css-extract-plugin -D
    2. 复制代码

    使用起来和上面的插件是差不多的

    1. let MiniCssExtractPlugin = require('mini-css-extract-plugin');
    2. module.exports = {
    3. module: {
    4. rules: [
    5. {
    6. test: /\.css$/,
    7. use: [MiniCssExtractPlugin.loader, 'css-loader']
    8. }
    9. ]
    10. },
    11. plugins: [
    12. new MiniCssExtractPlugin({
    13. filename: 'css/a.css' // 指定打包后的css
    14. })
    15. ]
    16. }
    17. 复制代码

    拆分成多个css

    这里要着重说一下上面两个插件的区别了,我个人还是建议用extract-text-webpack-plugin的,毕竟从之前的版本承接下来的,虽然在安包的时候需要@next,但是还是值得信赖的
    而且现在的extract-text-webpack-plugin也支持了拆分成多个css,而目前mini-css-extract-plugin还不支持此功能

    1. // 正常写入的less
    2. let styleLess = new ExtractTextWebpackPlugin('css/style.css');
    3. // reset
    4. let resetCss = new ExtractTextWebpackPlugin('css/reset.css');
    5. module.exports = {
    6. module: {
    7. rules: [
    8. {
    9. test: /\.css$/,
    10. use: resetCss.extract({
    11. use: 'css-loader'
    12. })
    13. },
    14. {
    15. test: /\.less$/,
    16. use: styleLess.extract({
    17. use: 'css-loader'
    18. })
    19. }
    20. ]
    21. },
    22. plugins: [
    23. styleLess,
    24. resetCss
    25. ]
    26. }
    27. 复制代码

    通过这样操作后可以打包成两个不同的css文件,如下图
    webpack4 - 图11

    引用图片

  • 处理图片方面,也需要loader

    1. npm i file-loader url-loader -D
    2. 复制代码

    如果是在css文件里引入的如背景图之类的图片,就需要指定一下相对路径

    1. module.exports = {
    2. module: {
    3. rules: [
    4. {
    5. test: /\.css$/,
    6. use: ExtractTextWebpackPlugin.extract({
    7. use: 'css-loader',
    8. publicPath: '../'
    9. })
    10. },
    11. {
    12. test: /\.(jpe?g|png|gif)$/,
    13. use: [
    14. {
    15. loader: 'url-loader',
    16. options: {
    17. limit: 8192, // 小于8k的图片自动转成base64格式,并且不会存在实体图片
    18. outputPath: 'images/' // 图片打包后存放的目录
    19. }
    20. }
    21. ]
    22. }
    23. ]
    24. }
    25. }
    26. 复制代码

    在css中指定了publicPath路径这样就可以根据相对路径引用到图片资源了,如下图所示
    webpack4 - 图12

    页面img引用图片

    页面中经常会用到img标签,img引用的图片地址也需要一个loader来帮我们处理好

    1. npm i html-withimg-loader -D
    2. 复制代码
    1. module.exports = {
    2. module: {
    3. rules: [
    4. {
    5. test: /\.(htm|html)$/,
    6. use: 'html-withimg-loader'
    7. }
    8. ]
    9. }
    10. }
    11. 复制代码

    这样再打包后的html文件下img就可以正常引用图片路径了
    webpack4 - 图13

    引用字体图片和svg图片

    字体图标和svg图片都可以通过file-loader来解析

    1. module.exports = {
    2. module: {
    3. rules: [
    4. {
    5. test: /\.(eot|ttf|woff|svg)$/,
    6. use: 'file-loader'
    7. }
    8. ]
    9. }
    10. }
    11. 复制代码

    这样即使样式中引入了这类格式的图标或者图片都没有问题了,img如果也引用svg格式的话,配合上面写好的html-withimg-loader就都没有问题了

    添加CSS3前缀

    通过postcss中的autoprefixer可以实现将CSS3中的一些需要兼容写法的属性添加响应的前缀,这样省去我们不少的时间
    由于也是一个loader加载器,我们也需要先安装一下

    1. npm i postcss-loader autoprefixer -D
    2. 复制代码

    安装后,我们还需要像webpack一样写一个config的配置文件,在项目根目录下创建一个postcss.config.js文件,配置如下:

    1. module.exports = {
    2. plugins: [require('autoprefixer')] // 引用该插件即可了
    3. }
    4. 复制代码

    然后在webpack里配置postcss-loader

    1. module.exports = {
    2. module: {
    3. rules: [
    4. {
    5. test: /\.css$/,
    6. use: ['style-loader', 'css-loader', 'postcss-loader']
    7. }
    8. ]
    9. }
    10. }
    11. 复制代码

    转义ES6

    在实际开发中,我们在大量的使用着ES6及之后的api去写代码,这样会提高我们写代码的速度,不过由于低版本浏览器的存在,不得不需要转换成兼容的代码,于是就有了常用的Babel了
    Babel会将ES6的代码转成ES5的代码
    那么不再多说,既然要使用它,就先来安一下

    1. npm i @babel/core babel-loader @babel/preset-env -D
    2. 复制代码

    当把这些都安好后,我们就开始配置,通过webpack里配置的babel-loader,就可以做到代码转成ES5了

    1. module.exports = {
    2. module: {
    3. rules: [
    4. {
    5. test:/\.js$/,
    6. use: {
    7. loader: 'babel-loader',
    8. // 配置选项里的presets
    9. // 包含ES6还有之后的版本和那些仅仅是草案的内容
    10. options: {
    11. presets: ['@babel/preset-env']
    12. }
    13. }
    14. include: /src/, // 只转化src目录下的js
    15. exclude: /node_modules/ // 排除掉node_modules,优化打包速度
    16. }
    17. ]
    18. }
    19. }
    20. 复制代码

    清空打包文件夹

    在我们每次npm run build的时候都会在dist目录下创建很多打好的包,如果积累过多可能也会混乱
    所以应该在每次打包之前将dist目录下的文件都清空,然后再把打好包的文件放进去
    这里提供一个clean-webpack-plugin插件

    1. npm i clean-webpack-plugin -D
    2. 复制代码
    1. let CleanWebpackPlugin = require('clean-webpack-plugin');
    2. module.exports = {
    3. plugins: [
    4. // 打包前先清空
    5. new CleanWebpackPlugin('dist')
    6. ]
    7. }
    8. 复制代码

    启动静态服务器

    启动一个静态服务器,默认会自动刷新,就是说你对html,css,js文件做了修改并保存后,浏览器会默认刷新一次展现修改后的效果
    正常情况下我们都是在开发环境中开发项目,所以之前配置的脚本”dev”可以派上用场了,在执行npm run dev命令后,会启动静态服务器,我们访问localhost:3000端口就可以看到开发的页面内容了
    如果devServer里open设为true后,会自动打开浏览器

    1. module.exports = {
    2. devServer: {
    3. contentBase: './dist',
    4. host: 'localhost', // 默认是localhost
    5. port: 3000, // 端口
    6. open: true, // 自动打开浏览器
    7. hot: true // 开启热更新
    8. }
    9. }
    10. 复制代码

    当然在npm run dev命令下,打包的文件存在于内存中,并不会产生在dist目录下

    热更新和自动刷新的区别

    在配置devServer的时候,如果hot为true,就代表开启了热更新
    But这并没那么简单,因为热更新还需要配置一个webpack自带的插件并且还要在主要js文件里检查是否有module.hot
    下面就让我们直接看下代码是如何实现的

    1. // webpack.config.js
    2. let webpack = require('webpack');
    3. module.exports = {
    4. plugins: [
    5. // 热更新,热更新不是刷新
    6. new webpack.HotModuleReplacementPlugin()
    7. ],
    8. devServer: {
    9. contentBase: './dist',
    10. hot: true,
    11. port: 3000
    12. }
    13. }
    14. // 此时还没完虽然配置了插件和开启了热更新,但实际上并不会生效
    15. // index.js
    16. let a = 'hello world';
    17. document.body.innerHTML = a;
    18. console.log('这是webpack打包的入口文件');
    19. // 还需要在主要的js文件里写入下面这段代码
    20. if (module.hot) {
    21. // 实现热更新
    22. module.hot.accept();
    23. }
    24. 复制代码

    以上index.js中的内容,如果将变量a的值进行修改保存后,会在不刷新页面的情况下直接修改掉,这样就实现了热更新
    那么热更新从现在看来和自动刷新浏览器的区别也不是太大嘛!自动刷新也是可以接受的啊
    其实不然,热更新的好处可能在vue或者react中有更大的发挥,其中某一个组件被修改的时候就会针对这个组件进行热更新了,这里用到vue或react的同学去实际体验一下吧

    resolve解析

    在webpack的配置中,resolve我们常用来配置别名和省略后缀名

    1. module.exports = {
    2. resolve: {
    3. // 别名
    4. alias: {
    5. $: './src/jquery.js'
    6. },
    7. // 省略后缀
    8. extensions: ['.js', '.json', '.css']
    9. },
    10. }
    11. 复制代码

    这个配置在webpack中比较简单,我们也就不再叙述了,下面来看点干货

    提取公共代码

    在webpack4之前,提取公共代码都是通过一个叫CommonsChunkPlugin的插件来办到的。到了4以后,内置了一个一模一样的功能,而且起了一个好听的名字叫“优化”
    下面我们就来看看如何提取公共代码

    1. // 假设a.js和b.js都同时引入了jquery.js和一个写好的utils.js
    2. // a.js和b.js
    3. import $ from 'jquery';
    4. import {sum} from 'utils';
    5. 复制代码

    那么他们两个js中其中公共部分的代码就是jquery和utils里的代码了
    可以针对第三方插件和写好的公共文件 ``` module.exports = { entry: {

    1. a: './src/a.js',
    2. b: './src/b.js'

    }, output: {

    1. filename: '[name].js',
    2. path: path.resolve('dust')

    }, // 提取公共代码

  • optimization: {
    1. splitChunks: {
    2. cacheGroups: {
    3. vendor: { // 抽离第三方插件
    4. test: /node_modules/, // 指定是node_modules下的第三方包
    5. chunks: 'initial',
    6. name: 'vendor', // 打包后的文件名,任意命名
    7. // 设置优先级,防止和自定义的公共代码提取时被覆盖,不进行打包
    8. priority: 10
    9. },
    10. utils: { // 抽离自己写的公共代码,utils这个名字可以随意起
    11. chunks: 'initial',
    12. name: 'utils', // 任意命名
    13. minSize: 0 // 只要超出0字节就生成一个新包
    14. }
    15. }
    16. }
  • }, plugins: [
    1. new HtmlWebpackPlugin({
    2. filename: 'a.html',
    3. template: './src/index.html', // 以index.html为模板
  • chunks: [‘vendor’, ‘a’] }), new HtmlWebpackPlugin({ filename: ‘b.html’, template: ‘./src/index.html’, // 以index.html为模板
  • chunks: [‘vendor’, ‘b’] }) ] } 复制代码 ``` 通过以上配置,可以把引入到a.js和b.js中的这部分公共代码提取出来,如下图所示
    webpack4 - 图14

    指定webpack配置文件

    在package.json的脚步里,我们可以配置调用不同的webpack配置文件进行打包,举个栗子
    webpack4 - 图15这样的好处在于可以针对不同的需求进行一个特定的打包配置

    就到这里吧

    关于webpack4的一些常规操作就说到这里了,其实在工作当中更多时候,也并不需要我们去配置这些内容
    不过我们要争做优秀的前端儿,所以就必须掌握这些必备的技能,必须会,没有之一!
    好了,就写到这里吧,想必大家也看累了吧,辛苦大家了,哈哈。