【前端工程化】三:模块化开发之webpack4

模块化开发

  • ESModules存在环境兼容问题

  • 模块文件过多,网络请求频繁

  • 所有的前端资源都需要模块化

需求,将所有ES6的代码编译成ES5或兼容性更好的代码,并且将转换后的代码打包成一个文件,并且支持不同类型的资源模块;前面两个需求可以使用前面学习的构建系统glup等,但是最后一个需求需要我们学习新的模块化打包工具;

Webpack4

yarn add webpack webpack-cli --dev

webpack支持0配置打包,默认会将src/index.js ->dist/main.js

yarn webpack

因为模块打包需要,所以处理import和export,并不会自动去处理其他问题,所以大多数情况下我们需要自定义配置,在当前目录下新建webpack.config.js文件;

entry:入口文件;

output:出口文件,接收一个对象;

  • filename为出口文件名;
  • path为出口文件目录,path属性必须是一个绝对路径,可以借助node中的path模块;

mode:工作模式,none,development,production,默认是production模式;

  • none模式只会进行普通的打包;
  • development模式会注重打包时长等;
  • production模式会做更多的优化;
module.exports = {
    entry: './src/main.js',
    output: {
        filename: 'bundle.js',
        path: path.join(__dirname, 'output')
    }
}

资源模块加载

webpack默认只会打包js文件,对于不同类型的资源文件需要使用相对应的Loader;

Loader是webpack的核心特性,借助于不同的Loader就可以加载任何类型的资源;

  • yarn add css-loader style-loader --dev

入口文件是main.css

const path = require('path')

module.exports = {
    entry: './src/main.css',
    output: {
        filename: 'main.js',
        path: path.join(__dirname, 'dist')
    },
    mode: 'none',
    module: {
        rules: [
            {
                test: /.css$/,
                use: [
                    'style-loader',
                    'css-loader'
                ]
            }
        ]
    }
}

推荐的做法是入口文件仍然是js文件,通过import引入css文件;

**webpack建议我们在编写代码的过程中引入当前代码所需要的任何文件;**这是webpack思想值得我们深刻学习的地方;

文件资源加载器

图片字体等文件的打包需要使用到文件资源加载器

按照webpack的思想,我们在需要引入图片的地方使用import来加载;

yarn add file-loader --dev

  • webpack4会默认所有的打包结果都放在了网站的根目录下面,需要配置文件告诉webpack打包的位置,在output的publicPath配置;(webpack5中没遇到这个问题,会自动)
  • 【前端工程化】三:模块化开发之webpack4
    配置了publicPath在dist/目录【前端工程化】三:模块化开发之webpack4

URL加载器

Data URLs:url就可以直接表示文件内容,不会发送http请求;

  • data:text/html;charset=UTF-8,

    html content

  • 图片或者字体文件可以通过base64编码来表示文件内容, data:image/png;base64,iasfasfaskfl…asfasf

yarn add url-loader --dev

此时dist目录下就没有file-loader生成的png文件了,在打包的js文件中以base64的格式来表示图片;

建议: 小文件使用Data URLs,减少请求次数,大文件单独提取存放,提高加载速度;

const path = require('path')

module.exports = {
    entry: './src/main.js',
    output: {
        filename: 'main.js',
        path: path.join(__dirname, 'dist'),
        // publicPath: '/dist/'
    },
    mode: 'none',
    module: {
        rules: [
            {
                test: /.css$/,
                use: [
                    'style-loader',
                    'css-loader'
                ]
            },
            {
                test: /.png$/,
                use: {
                    loader: 'url-loader',
                    options: {
                        limit: 10 * 1024 // 10kb
                    }
                }
            }
        ]
    }
}

当超过10kb的图片会以file-loader的形式去处理,小于10kb的图片转换为Data URLs嵌入代码中;

**注意:**这样使用url-loader之前必须下载file-loader;

常用加载器分类

编译转换类(css-loader),文件操作类(file-loader),代码检查类(eslint-loader);

Babel-loader

yarn add babel-loader @babel/core @babel/preset-env --dev

{
    test: /.js$/,
        use: {
            loader: 'babel-loader',
                options: {
                    presets: ['@babel/preset-env']
                }
        }
}

加载资源的方式

  • 遵循ES Modules标准的import声明
  • 遵循CommonJS标准的require函数
  • 遵循AMD标准的define函数和require函数
  • 样式代码中的@import指令和url函数
  • 默认只支持html代码中图片标签的src属性,需要在attrs属性中手动配置a标签的herf属性等

yarn add html-loader --dev

{
    test: /.html$/,
        use: {
            loader: 'html-loader',
                options: {
                    attrs: ['img:src', 'a:href']
                }
        }
},

webpack核心工作原理

webpack会根据配置找到其中一个文件作为入口,顺着入口文件的代码,根据import或者require等语句,解析推断出文件所依赖的资源模块,分别去解析每个资源模块对应的依赖,最后形成整个项目的依赖树,webpack递归这个依赖树找到每个节点依赖的资源文件,在根据配置文件中rules属性找到资源文件对应的loader,最后将加载到的结果放入指定的出口文件中,从而实现整个项目的打包;如果没有loader那么webpack只能是一个用来打包和合并js代码的工具;

webpack开发一个Loader

loader的工作过程类似一个流的工作过程,我们可以尝试手动开发一个解析md文档的loader

  • loader接收加载到的文件资源的内容,输出此处加载过后的结果,如果是最后一个loader,则必须是可执行的js代码,此时有两种解决方法,要么返回一个可执行的js代码,要么选择一个合适的loader接着去处理返回的结果;

例:当loader返回可执行的js代码时

【前端工程化】三:模块化开发之webpack4
打包后的bundle.js中会出现这段可执行的js代码

【前端工程化】三:模块化开发之webpack4
所以需要返回一个可执行的js代码

// markdown-loader.js中
const marked = require('marked')

module.exports = source => {
  // return 'hello'
  // return 'console.log("hello ~")'
  const html = marked(source)
  // return html
  // return `module.exports = ${JSON.stringify(html)}`
  // return `export default ${JSON.stringify(html)}`

  // 返回 html 字符串交给下一个 loader 处理
  return html
}


// webpack.config中
const path = require('path')

module.exports = {
  mode: 'none',
  entry: './src/main.js',
  output: {
    filename: 'bundle.js',
    path: path.join(__dirname, 'dist'),
    publicPath: 'dist/'
  },
  module: {
    rules: [
      {
        test: /.md$/,
        use: [
          'html-loader',
          './markdown-loader'
        ]
      }
    ]
  }
}

webpack的插件机制

Plugin用来解决其他自动化工作,例如清除dist目录,拷贝静态资源文件,压缩输出代码等;

webpack常用插件

绝大多数插件导出的是一个类,在plugins属性中放入实例对象;

清除插件: yarn add clean-wbpack-plugin --dev

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

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

**自动生成HTML插件:**yarn add html-webpack-plugin --dev

  • 我们之前采用硬编码的方式,自己新建了html文件,然后引入了dist下打包后的bundle.js文件,这样存在很多的问题,比如引入js文件的目录需要我们手动修改;

  • 使用插件以后同样会导出一个html文件,而且是动态引入的js文件;

  • 原先我们在output属性中设置了publicPath来告诉webpack我们打包后的公共目录,现在自动生成了html文件则不需要配置publicPath属性了;

  • 简单html文件我们可以通过配置选项来指定参数,复杂的html文件我们可以指定模板template,模板的html文件支持lodash模板引擎语法,通过htmlWebpackPlugin.options来获取配置选项

    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <meta http-equiv="X-UA-Compatible" content="ie=edge">
      <title>Webpack</title>
    </head>
    <body>
      <div class="container">
        <h1><%= htmlWebpackPlugin.options.title %></h1>
      </div>
    </body>
    </html>
    
    
  • 使用多个实例对象可用于导出多个html文件;

    const HtmlWebpackPlugin = require('html-webpack-plugin')
    
    module.exports = {
      mode: 'none',
      entry: './src/main.js',
      output: {
        filename: 'bundle.js',
        path: path.join(__dirname, 'dist'),
        publicPath: 'dist/'
      },
      plugins: [
        // 用于生成 index.html
        new HtmlWebpackPlugin({
          title: 'Webpack Plugin Sample',
          meta: {
            viewport: 'width=device-width'
          },
          template: './src/index.html'
        }),
        // 用于生成 about.html
        new HtmlWebpackPlugin({
          filename: 'about.html' // 指定生成的html文件名
        })
      ]
    }
    

**copy-webpack-plugin:**yarn add copy-webpack-plugin

开发阶段我们一般不会使用这个文件

静态资源文件的复制,放入静态资源的目录名 https://cloud.tencent.com/developer/section/1477556

传入一个数组,指定静态资源文件目录

const CopyWebpackPlugin = require('copy-webpack-plugin')

plugins: [
    new CopyWebpackPlugin([
        // 'public/**'
        'public'
    ])
]

webpack开发一个Plugin

Plugin通过钩子机制实现,webpack要求插件必须是一个函数或者是一个包含apply方法的对象;

现在我们开发一个用来清除bundle.js中的注释的插件;

  • apply接收compiler参数,包含了所有的配置信息
  • https://webpack.docschina.org/api/compiler-hooks/#emit
class MyPlugin {
  apply (compiler) {
    console.log('MyPlugin 启动')

    compiler.hooks.emit.tap('MyPlugin', compilation => {
      // compilation => 可以理解为此次打包的上下文
      for (const name in compilation.assets) {
        // console.log(name)
        // console.log(compilation.assets[name].source())
        if (name.endsWith('.js')) {
          const contents = compilation.assets[name].source()
          const withoutComments = contents.replace(/\/\*\*+\*\//g, '')
          compilation.assets[name] = {
            source: () => withoutComments,
            size: () => withoutComments.length
          }
        }
      }
    })
  }
}

webpack开发体验问题

上面我们都是通过 编写源代码 =》webpack打包 =》 运行应用 =》 刷新浏览器 的方式来开发

  • 我们的项目应该以http的形式访问
  • 自动编译 + 自动刷新

自动编译: 我们可以使用watch工作模式来监听文件的变动,重新编译;

  • yarn webpack --watch

watch模式会自动编译代码,然后我们需要手动刷新浏览器才可以看到最新的结果

**自动刷新:**BrowserSync插件可以帮我们实现自动刷新的功能;

  • browser-sync dist --files “**/*”

webpack自动编译到我们的dist目录中,被browser-sync拦截到变化然后自动刷新

**但是!**这么做的话操作麻烦,并且需要反复读取磁盘效率低下,要是有更好的工具能替代就完美了!

Webpack Dev Server

yarn add webpack-dev-server --dev

yarn webpack-dev-server

  • webpack.config.js为dev server指定了一个devServer的属性,传入对象;
  • 其中contentBase为devServer服务器额外指定了查找资源目录,因为在开发阶段我们通常不会使用copy-webpack-plugin去复制静态资源,所以我们配置contentBase属性来指定静态资源的目录;
  • 在实际开发中,项目如果上线到生产环境中我们可以实际访问到api,但是在本地的时候使用本地服务器访问会产生跨域问题;使用CORS的前提是APT必须支持,但是如果是同源部署的话,没必要支持CORS,所以需要在前端开发服务器中来配置代理服务;
devServer: {
    contentBase: './public',
    proxy: {
        '/api': {
            // http://localhost:8080/api/users -> https://api.github.com/api/users
            target: 'https://api.github.com',
            // http://localhost:8080/api/users -> https://api.github.com/users
            pathRewrite: {
                '^/api': ''
            },
            // 不能使用 localhost:8080 作为请求 GitHub 的主机名
            changeOrigin: true
        }
    }
},

Source Map

映射转换之后的代码与源代码之间的关系

在源文件中的最后使用注释 //# sourceMappingURL=bundle.js.map 来引入source Map

webpack现在支持12种source Map模式,这里只给推荐;

开发环境: cheap-module-eval-source-map

  • 代码行数不超过80个字符
  • 经过Loader转换过后的差异较大
  • 首次打包速度慢无所谓,重写打包相对较快

生产模式: none 或者 nosources-source-map

  • Source Map会暴露源代码

webpack HMR体验

前面我们配置了自动刷新,但是每次自动刷新都会丢失状态,体验不友好;

问题核心: 自动刷新导致的页面状态丢失;

开启HMR: 可以通过 yarn webpack-dev-server --hot 或者在配置文件中配置

const webpack = require('webpack')

module.exports = {
  mode: 'development',
  entry: './src/main.js',
  output: {
    filename: 'js/bundle.js'
  },
  devtool: 'source-map',
  devServer: {
    hot: true,
  },
  plugins: [
    new webpack.HotModuleReplacementPlugin()
  ]
}

Q1: 当我们修改css文件时,可以直接热更新,但是修改了js文件时,会自动刷新?

  • 因为css-loader自动处理了热更新,但是js模块没有任何规律,所以没办法处理;

Q2: 项目中使用了框架,js照样可以热替换?

  • 因为我们使用了框架,框架下的每种文件都是有规律的,通过脚手架创建的项目内部都集成了HMR方案;

注意: webapck中的HMR并不是开箱即用的,需要手动处理模块热替换逻辑;

HMR API

  • module.hot提供了热更新的api,使用module.hot.accept来注册热更新

  • 当使用了module.hot.accept来注册了模块的热更新以后,模块发生改变就不会触发自动刷新了

  • 也可以通过配置文件中hotOnly属性来配置,无论该模块是否配置了热更新,都不会刷新浏览器,这样就可以看到错误信息了

    // webpack.congfig.js
    devServer: {
        // hot: true,
        hotOnly: true
    },
    
  • 使用了HMR提供的API但是没有开启HMR的选项,则会报错,所以最外面加一个if (module.hot)判断是否存在

  • 为了实现热更新,我们在业务代码中写了很多与业务无关的代码,但是在生产环境中,我们去除了HMR插件,false以后并不会影响生产环境的状态;

import createEditor from './editor'
import background from './better.png'
import './global.css'

const editor = createEditor()
document.body.appendChild(editor)

const img = new Image()
img.src = background
document.body.appendChild(img)

// ================================================================
// HMR 手动处理模块热更新
// 不用担心这些代码在生产环境冗余的问题,因为通过 webpack 打包后,
// 这些代码全部会被移除,这些只是开发阶段用到
if (module.hot) {
  let hotEditor = editor
  module.hot.accept('./editor.js', () => {
    // 当 editor.js 更新,自动执行此函数
    // 临时记录编辑器内容
    const value = hotEditor.innerHTML
    // 移除更新前的元素
    document.body.removeChild(hotEditor)
    // 创建新的编辑器
    // 此时 createEditor 已经是更新过后的函数了
    hotEditor = createEditor()
    // 还原编辑器内容
    hotEditor.innerHTML = value
    // 追加到页面
    document.body.appendChild(hotEditor)
  })

  module.hot.accept('./better.png', () => {
    // 当 better.png 更新后执行
    // 重写设置 src 会触发图片元素重新加载,从而局部更新图片
    img.src = background
  })

  // style-loader 内部自动处理更新样式,所以不需要手动处理样式模块
}

webpack生产环境优化

生产环境与开发环境的差别大,开发环境注重开发效率,而生产环境注重运行效率;

webpack4提供了mode模式,在生产环境下为我们提供了很多默认的配置;

要使用不同环境下的配置有以下方法

  1. 配置文件根据环境不同导出不同配置;

    配置文件导出的函数中,会传入两个参数,其中env就是环境变量,可以根据env对不同环境做不同配置;

    const webpack = require('webpack')
    const { CleanWebpackPlugin } = require('clean-webpack-plugin')
    const HtmlWebpackPlugin = require('html-webpack-plugin')
    const CopyWebpackPlugin = require('copy-webpack-plugin')
    
    module.exports = (env, argv) => {
      const config = {
        ....// 开发环境下的配置
      }
    
      if (env === 'production') {
        config.mode = 'production'
        config.devtool = false
        config.plugins = [
          ...config.plugins,
          new CleanWebpackPlugin(),
          new CopyWebpackPlugin(['public'])
        ]
      }
    
      return config
    }
    
    
  2. 一个环境对应一个配置文件,通常会配置三个文件,公共配置、开发环境配置、生产环境配置;

    对于配置文件的合并,我们一般会用到webpack-merge插件;

    const webpack = require('webpack')
    const merge = require('webpack-merge')
    const common = require('./webpack.common')
    
    module.exports = merge(common, {
      mode: 'development',
      devtool: 'cheap-eval-module-source-map',
      devServer: {
        hot: true,
        contentBase: 'public'
      },
      plugins: [
        new webpack.HotModuleReplacementPlugin()
      ]
    })
    

DefinePlugin

为代码注入全局成员,在production模式下默认会启用并注入process.env.NODE_ENV

  • DefinePlugin要求我们定义的值是一个代码片段(与Loader中返回的值相似)
const webpack = require('webpack')

module.exports = {
  mode: 'none',
  entry: './src/main.js',
  output: {
    filename: 'bundle.js'
  },
  plugins: [
    new webpack.DefinePlugin({
      // 值要求的是一个代码片段
      API_BASE_URL: JSON.stringify('https://api.example.com')
      // API_BASE_URL: " 'https://api.example.com' "
    })
  ]
}

Tree-shaking

a文件中导出了三个方法,b文件只引入了其中一个方法,另外两个方法就是未引用代码;

Tree-shaking就是去除未引用代码,tree-shaking并不是值某个配置选项,而是一组功能搭配使用后的效果,会在production模式下自动开启;

webpack配置中提供optimization属性,用来集中配置webpack的优化功能;

  • usedExports的作用类似于标记枯树叶,而minimize的作用就是负责摇掉他们
  • webpack会将一个模块分别打包进一个函数,concatenateModules的作用就是尽可能的将所有模块合并输出到一个函数中,这样既提升了运行效率,又减少了代码的体积,被称为Scope Hoisting(作用域提升)
module.exports = {
  mode: 'none',
  entry: './src/index.js',
  output: {
    filename: 'bundle.js'
  },
  optimization: {
    // 模块只导出被使用的成员
    usedExports: true,
    // 尽可能合并每一个模块到一个函数中
    concatenateModules: true,
    // 压缩输出结果
    minimize: true
  }
}

**注意:**Tree-shaking前提是ES Module模式模块化,在我们使用的@babel/preset-env会将ES Module转换成Common JS模式,所以会导致Tree-shaking失效;

可以去配置中修改babel的转换方式

module: {
    rules: [
        {
            test: /\.js$/,
            use: {
                loader: 'babel-loader',
                options: {
                    presets: [
                        // 如果 Babel 加载模块时已经转换了 ESM,则会导致 Tree Shaking 失效
                        // ['@babel/preset-env', { modules: 'commonjs' }]
                        // ['@babel/preset-env', { modules: false }]
                        // 也可以使用默认配置,也就是 auto,这样 babel-loader 会自动关闭 ESM 转换
                        ['@babel/preset-env', { modules: 'auto' }]
                    ]
                }
            }
        }
    ]
},

sideEffects

副作用:模块执行时除了导出成员之外所作的事情(比如在Number的原型对象上新增一个方法),一般用于npm包标记是否有副作用;

optimization属性中开启sideEffects,开启之后webpack就会检查当前代码所属的package.json有没有sideEffects标识,以此来判断该模块是否有副作用,如果该模块没有副作用,那么webpack就不会将它打包;

  • 代码中的css模块都属于副作用

webpack.config.js中

module.exports = {
  mode: 'none',
  entry: './src/index.js',
  output: {
    filename: 'bundle.js'
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          'style-loader',
          'css-loader'
        ]
      }
    ]
  },
  optimization: {
    sideEffects: true,
    // 模块只导出被使用的成员
    // usedExports: true,
    // 尽可能合并每一个模块到一个函数中
    // concatenateModules: true,
    // 压缩输出结果
    // minimize: true,
  }
}

package.json中

{
  "name": "31-side-effects",
  "version": "0.1.0",
  "main": "index.js",
  "author": "zce <w@zce.me> (https://zce.me)",
  "license": "MIT",
  "scripts": {
    "build": "webpack"
  },
  "devDependencies": {
    "css-loader": "^3.2.0",
    "style-loader": "^1.0.0",
    "webpack": "^4.41.2",
    "webpack-cli": "^3.3.9"
  },
  // 标记该项目中都没有副作用
  // "sideEffects": false
  "sideEffects": [
  	"*.css",
  	"./src/extend.js"
  ]
}

代码分割

项目的所有代码都会打包到了一起,当项目越来越大的时候,会导致bundle.js的体积特别大,但是并不是每个模块在启动的时候都是必要的;更为合理是把我们打包的结果按照一定的规则去分离到多个bundle.js中,根据我们定义的运行需要,按需加载;

http1.1版本的缺陷

  • 同域并行请求限制
  • 每次请求都会有一定的延迟
  • 请求的Header浪费带宽流量

为了解决以上的需求,webpack支持了Code Splitting(代码分包/代码分割),有以下两种实现方式:

  • 多入口打包
  • 动态导入

多入口打包

一般适用于多页应用程序,一个页面对应一个入口,公共部分单独提取;

  • entry配置为对象
  • output中以[name]来表示不同的入口文件
  • HtmlWebpackPlugin插件会默认引入所有打包后的js,所以配置不同的chunks属性来指定引入的js文件
  • 公共部分提取配置optimization属性中的splitChunks属性,指定chunks为all;
const { CleanWebpackPlugin } = require('clean-webpack-plugin')
const HtmlWebpackPlugin = require('html-webpack-plugin')

module.exports = {
  mode: 'none',
  entry: {
    index: './src/index.js',
    album: './src/album.js'
  },
  output: {
    filename: '[name].bundle.js'
  },
  optimization: {
    splitChunks: {
      // 自动提取所有公共模块到单独 bundle
      chunks: 'all'
    }
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          'style-loader',
          'css-loader'
        ]
      }
    ]
  },
  plugins: [
    new CleanWebpackPlugin(),
    new HtmlWebpackPlugin({
      title: 'Multi Entry',
      template: './src/index.html',
      filename: 'index.html',
      chunks: ['index']
    }),
    new HtmlWebpackPlugin({
      title: 'Multi Entry',
      template: './src/album.html',
      filename: 'album.html',
      chunks: ['album']
    })
  ]
}

动态导入

需要用到某个模块时,再加载这个模块

动态导入的模块会被自动分包,import(’./posts/posts’)

魔法注释

动态导入的模块打包后的文件名都为序号,如果想要给打包后的文件命名,可以使用魔法注释;

相同的webapackChunkName会被打包到一起;

if (hash === '#posts') {
    import(/* webpackChunkName: 'components' */'./posts/posts').then(({ default: posts }) => {
      mainElement.appendChild(posts())
    })
  } else if (hash === '#album') {
    import(/* webpackChunkName: 'components' */'./album/album').then(({ default: album }) => {
      mainElement.appendChild(album())
    })
  }

MiniCssExtractPlugin

将Css文件单独提取一个文件中,推荐当css文件大于150kb时在考虑使用该插件,否则会多一次css的请求;

  • 使用了插件以后,在css的loader配置中就不需要使用style-loader来注入css,而是使用MiniCssExtractPlugin.loader(会通过link的方式来注入)
const MiniCssExtractPlugin = require('mini-css-extract-plugin')


...
module: {
    rules: [
        {
            test: /\.css$/,
            use: [
                // 'style-loader', // 将样式通过 style 标签注入
                MiniCssExtractPlugin.loader,
                'css-loader'
            ]
        }
    ]
},

optimize-css-assets-webpack-plugin

webpack默认只会压缩js文件,经过分包后的css并没有被压缩,这时候我们需要借助插件

...
const OptimizeCssAssetsWebpackPlugin = require('optimize-css-assets-webpack-plugin')

module.exports = {
  ...,
  plugins: [
    ...,
    new OptimizeCssAssetsWebpackPlugin()
  ]
}
  • OptimizeCssAssetsWebpackPlugin除了配置在plugins属性中,还可以配置在optimization属性的minimizer属性,webpack建议我们把压缩代码的这种操作都防止在minimizer中,只有开启了minimizer时(比如生产模式)才会执行压缩指令;
  • 当我们手动配置了minimizer属性时,webpack会认为我们要去自定义压缩器插件,所以此时js文件不会压缩(生产模式);这是需要我们手动去配置js的压缩插件TerserWebpackPlugin
const { CleanWebpackPlugin } = require('clean-webpack-plugin')
const HtmlWebpackPlugin = require('html-webpack-plugin')
const MiniCssExtractPlugin = require('mini-css-extract-plugin')
const OptimizeCssAssetsWebpackPlugin = require('optimize-css-assets-webpack-plugin')
const TerserWebpackPlugin = require('terser-webpack-plugin')

module.exports = {
  mode: 'none',
  entry: {
    main: './src/index.js'
  },
  output: {
    filename: '[name].bundle.js'
  },
  devtool: 'cheap-eval-source-map',
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          // 'style-loader', // 将样式通过 style 标签注入
          MiniCssExtractPlugin.loader,
          'css-loader'
        ]
      }
    ]
  },
  optimization: {
    minimizer: [
      new OptimizeCssAssetsWebpackPlugin(),
      new TerserWebpackPlugin()
    ]
  },
  plugins: [
    new CleanWebpackPlugin(),
    new MiniCssExtractPlugin(),
    new HtmlWebpackPlugin({
      template: 'src/index.html',
      title: 'xp item'
    }),
    new OptimizeCssAssetsWebpackPlugin()
  ]
}

输出文件名Hash

在缓存策略中,如果我们把缓存时间设置的过短,那效果可能不是很明显,一旦把时间设置的很长,那应用更新重新部署以后没有办法及时更新到后端,所以生产模式下,文件名使用Hash,当资源文件发生改变时,文件名称也会发生变化,对于后端而言就是全新的请求,这样我们可以把缓存策略的时间设置的比较长,不用担心更新不及时的问题;

配置中的所有filename等路径都支持hash模式

hash有以下三种模式:

  • filename: ‘[name]-[hash].bundle.css’;

    hash模式,当项目中任何一个地方发生改变,所有文件的hash都会发生改变

  • filename: ‘[name]-[chunkhash].bundle.css’;

    chunkhash模式,chunk级别的hash,项目中一路的chunk的hash值是相同的(项目中使用动态导入时会形成多路chunk),改变时只会影响当前路的hash值

  • filename: ‘[name]-[contenthash].bundle.css’;

    contenthash模式,文件级别的hash,不同的文件就有不同的hash值;

  • 默认hash长度为20,可以手动指定长度,个人认为8位左右就可以了

    filename: ‘[name]-[contenthash:8].bundle.css’

const { CleanWebpackPlugin } = require('clean-webpack-plugin')
const HtmlWebpackPlugin = require('html-webpack-plugin')
const MiniCssExtractPlugin = require('mini-css-extract-plugin')
const OptimizeCssAssetsWebpackPlugin = require('optimize-css-assets-webpack-plugin')
const TerserWebpackPlugin = require('terser-webpack-plugin')

module.exports = {
  mode: 'none',
  entry: {
    main: './src/index.js'
  },
  output: {
    filename: '[name]-[contenthash:8].bundle.js'
  },
  optimization: {
    minimizer: [
      new TerserWebpackPlugin(),
      new OptimizeCssAssetsWebpackPlugin()
    ]
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          // 'style-loader', // 将样式通过 style 标签注入
          MiniCssExtractPlugin.loader,
          'css-loader'
        ]
      }
    ]
  },
  plugins: [
    new CleanWebpackPlugin(),
    new HtmlWebpackPlugin({
      title: 'Dynamic import',
      template: './src/index.html',
      filename: 'index.html'
    }),
    new MiniCssExtractPlugin({
      filename: '[name]-[contenthash:8].bundle.css'
    })
  ]
}
上一篇:TypeError: this.getOptions is not a function style标签引入less报错的问题


下一篇:一份Android的.gitignore文件