一、Webpack 简介

1.1 webpack 是什么

webpack 是一种前端资源构建工具,一个静态模块打包器(module bundler)。
在webpack 看来, 前端的所有资源文件(js/json/css/img/less/…)都会作为模块处理。
它将根据模块的依赖关系进行静态分析,打包生成对应的静态资源(bundle)。

1.2 webpack 五个核心概念

1.2.1 Entry

入口(Entry):指示 webpack 以哪个文件为入口起点开始打包,分析构建内部依赖图。

1.2.2 Output

输出(Output):指示 webpack 打包后的资源 bundles 输出到哪里去,以及如何命名。

1.2.3 Loader

Loader:让 webpack 能够去处理那些非 JS 的文件,比如样式文件、图片文件(webpack 自身只理解
JS)

1.2.4 Plugins

插件(Plugins):可以用于执行范围更广的任务。插件的范围包括,从打包优化和压缩,
一直到重新定义环境中的变量等。

1.2.5 Mode

模式(Mode):指示 webpack 使用相应模式的配置。

选项 描述 特点
development 会将 DefinePlugin 中 process.env.NODE_ENV 的值设置为 development。启用 NamedChunksPlugin 和 NamedModulesPlugin。 能让代码本地调试运行的环境
production 会将 DefinePlugin 中 process.env.NODE_ENV 的值设置为 production。启用 FlagDependencyUsagePlugin, FlagIncludedChunksPlugin, ModuleConcatenationPlugin, NoEmitOnErrorsPlugin, OccurrenceOrderPlugin, SideEffectsFlagPlugin 和 TerserPlugin。 能让代码优化上线运行的环境

二、Webpack 初体验

2.1 初始化配置

  1. 初始化 package.json:npm init
  2. 下载安装webpack:(webpack4以上的版本需要全局/本地都安装webpack-cli)
    全局安装:cnpm i webpack webpack-cli -g
    本地安装:cnpm i webpack webpack-cli -D

    2.2 编译打包应用

    创建 src 下的 js 等文件后,不需要配置 webpack.config.js 文件,在命令行就可以编译打包。
    指令:
  • 开发环境:webpack ./src/index.js -o ./build/built.js —mode=development
    webpack会以 ./src/index.js 为入口文件开始打包,打包后输出到 ./build/built.js 整体打包环境,是开发环境
  • 生产环境:webpack ./src/index.js -o ./build/built.js —mode=production
    webpack会以 ./src/index.js 为入口文件开始打包,打包后输出到 ./build/built.js 整体打包环境,是生产环境

结论:

  1. webpack 本身能处理 js/json 资源,不能处理 css/img 等其他资源
  2. 生产环境和开发环境将 ES6 模块化编译成浏览器能识别的模块化,但是不能处理 ES6 的基本语法转化为 ES5(需要借助 loader)
  3. 生产环境比开发环境多一个压缩 js 代码

    三、Webpack 开发环境的基本配置

    webpack.config.js 是 webpack 的配置文件。
    作用: 指示 webpack 干哪些活(当你运行 webpack 指令时,会加载里面的配置)
    所有构建工具都是基于 nodejs 平台运行的,模块化默认采用 commonjs。
    开发环境配置主要是为了能让代码运行。主要考虑以下几个方面:
  • 打包样式资源
  • 打包 html 资源
  • 打包图片资源
  • 打包其他资源
  • devServer

下面是一个简单的开发环境webpack.confg.js配置文件

  1. // resolve用来拼接绝对路径的方法
  2. const { resolve } = require('path')
  3. const HtmlWebpackPlugin = require('html-webpack-plugin') // 引用plugin
  4. module.exports = {
  5. // webpack配置a
  6. entry: './src/js/index.js', // 入口起点
  7. output: {
  8. // 输出
  9. // 输出文件名
  10. filename: 'js/build.js',
  11. // __dirname是nodejs的变量,代表当前文件的目录绝对路径
  12. path: resolve(__dirname, 'build'), // 输出路径,所有资源打包都会输出到这个文件夹下
  13. },
  14. // loader配置
  15. module: {
  16. rules: [
  17. // 详细的loader配置
  18. // 不同文件必须配置不同loader处理
  19. {
  20. // 匹配哪些文件
  21. test: /\.less$/,
  22. // 使用哪些loader进行处理
  23. use: [
  24. // use数组中loader执行顺序:从右到左,从下到上,依次执行(先执行css-loader)
  25. // style-loader:创建style标签,将js中的样式资源插入进去,添加到head中生效
  26. 'style-loader',
  27. // css-loader:将css文件变成commonjs模块加载到js中,里面内容是样式字符串
  28. 'css-loader',
  29. // less-loader:将less文件编译成css文件,需要下载less-loader和less
  30. 'less-loader'
  31. ],
  32. },
  33. {
  34. test: /\.css$/,
  35. use: ['style-loader', 'css-loader'],
  36. },
  37. {
  38. // url-loader:处理图片资源,问题:默认处理不了html中的img图片
  39. test: /\.(jpg|png|gif)$/,
  40. // 需要下载 url-loader file-loader
  41. loader: 'url-loader',
  42. options: {
  43. // 图片大小小于8kb,就会被base64处理,优点:减少请求数量(减轻服务器压力),缺点:图片体积会更大(文件请求速度更慢)
  44. // base64在客户端本地解码所以会减少服务器压力,如果图片过大还采用base64编码会导致cpu调用率上升,网页加载时变卡
  45. limit: 8 * 1024,
  46. // 给图片重命名,[hash:10]:取图片的hash的前10位,[ext]:取文件原来扩展名
  47. name: '[hash:10].[ext]',
  48. // 问题:因为url-loader默认使用es6模块化解析,而html-loader引入图片是conmonjs,解析时会出问题:[object Module]
  49. // 解决:关闭url-loader的es6模块化,使用commonjs解析
  50. esModule: false,
  51. outputPath: 'imgs',
  52. },
  53. },
  54. {
  55. test: /\.html$/,
  56. // 处理html文件的img图片(负责引入img,从而能被url-loader进行处理)
  57. loader: 'html-loader',
  58. },
  59. // 打包其他资源(除了html/js/css资源以外的资源)
  60. {
  61. // 排除html|js|css|less|jpg|png|gif文件
  62. exclude: /\.(html|js|css|less|jpg|png|gif)/,
  63. // file-loader:处理其他文件
  64. loader: 'file-loader',
  65. options: {
  66. name: '[hash:10].[ext]',
  67. outputPath: 'media',
  68. },
  69. },
  70. ],
  71. },
  72. // plugin的配置
  73. plugins: [
  74. // html-webpack-plugin:默认会创建一个空的html文件,自动引入打包输出的所有资源(JS/CSS)
  75. // 需要有结构的HTML文件可以加一个template
  76. new HtmlWebpackPlugin({
  77. // 复制这个./src/index.html文件,并自动引入打包输出的所有资源(JS/CSS)
  78. template: './src/index.html',
  79. }),
  80. ],
  81. // 模式
  82. mode: 'development', // 开发模式
  83. // 开发服务器 devServer:用来自动化,不用每次修改后都重新输入webpack打包一遍(自动编译,自动打开浏览器,自动刷新浏览器)
  84. // 特点:只会在内存中编译打包,不会有任何输出(不会像之前那样在外面看到打包输出的build包,而是在内存中,关闭后会自动删除)
  85. // 启动devServer指令为:npx webpack-dev-server
  86. devServer: {
  87. // 项目构建后路径
  88. contentBase: resolve(__dirname, 'build'),
  89. // 启动gzip压缩
  90. compress: true,
  91. // 端口号
  92. port: 3000,
  93. // 自动打开浏览器
  94. open: true,
  95. },
  96. }

其中,大部分配置都在注释中给出解释。

  • 运行项目的两个指令:
    webpack 会将打包结果输出出去(build文件夹)
    npx webpack-dev-server 只会在内存中编译打包,没有输出
  • loader 和 plugin 的不同:(plugin 一定要先引入才能使用)
    loader:1. 下载 2. 使用(配置 loader)
    plugins:1.下载 2. 引入 3. 使用

    四、Webpack 生产环境的基本配置

    而生产环境的配置需要考虑以下几个方面:

  • 提取 css 成单独文件

  • css 兼容性处理
  • 压缩 css
  • js 语法检查
  • js 兼容性处理
  • js 压缩
  • html 压缩

下面是一个基本的生产环境下的webpack.config.js配置

  1. const { resolve } = require('path')
  2. const MiniCssExtractorPlugin = require('mini-css-extract-plugin')
  3. const OptimiziCssAssetsWebpackPlugin = require('optimizi-css-assets-webpack-plugin')
  4. const HtmlWebpackPlugin = require('html-webpack-plugin')
  5. // 定义node.js的环境变量,决定使用browserslist的哪个环境
  6. process.env.NODE_ENV = 'production'
  7. // 复用loader的写法
  8. const commonCssLoader = [
  9. // 这个loader取代style-loader。作用:提取js中的css成单独文件然后通过link加载
  10. MiniCssExtractPlugin.loader,
  11. // css-loader:将css文件整合到js文件中
  12. // 经过css-loader处理后,样式文件是在js文件中的
  13. // 问题:1.js文件体积会很大2.需要先加载js再动态创建style标签,样式渲染速度就慢,会出现闪屏现象
  14. // 解决:用MiniCssExtractPlugin.loader替代style-loader
  15. 'css-loader',
  16. /*
  17. postcss-loader:css兼容性处理:postcss --> 需要安装:postcss-loader postcss-preset-env
  18. postcss需要通过package.json中browserslist里面的配置加载指定的css兼容性样式
  19. 在package.json中定义browserslist:
  20. "browserslist": {
  21. // 开发环境 --> 设置node环境变量:process.env.NODE_ENV = development
  22. "development": [ // 只需要可以运行即可
  23. "last 1 chrome version",
  24. "last 1 firefox version",
  25. "last 1 safari version"
  26. ],
  27. // 生产环境。默认是生产环境
  28. "production": [ // 需要满足绝大多数浏览器的兼容
  29. ">0.2%",
  30. "not dead",
  31. "not op_mini all"
  32. ]
  33. },
  34. */
  35. {
  36. loader: 'postcss-loader',
  37. options: {
  38. ident: 'postcss', // 基本写法
  39. plugins: () => [
  40. // postcss的插件
  41. require('postcss-preset-env')(),
  42. ],
  43. },
  44. },
  45. ]
  46. module.exports = {
  47. entry: './src/js/index.js',
  48. output: {
  49. filename: 'js/built.js',
  50. path: resolve(__dirname, 'build'),
  51. },
  52. module: {
  53. rules: [
  54. {
  55. test: /\.css$/,
  56. use: [...commonCssLoader],
  57. },
  58. {
  59. test: /\.less$/,
  60. use: [...commonCssLoader, 'less-loader'],
  61. },
  62. /*
  63. 正常来讲,一个文件只能被一个loader处理
  64. 当一个文件要被多个loader处理,那么一定要指定loader执行的先后顺序
  65. 先执行eslint再执行babel(用enforce)
  66. */
  67. {
  68. /*
  69. js的语法检查: 需要下载 eslint-loader eslint
  70. 注意:只检查自己写的源代码,第三方的库是不用检查的
  71. airbnb(一个流行的js风格) --> 需要下载 eslint-config-airbnb-base eslint-plugin-import
  72. 设置检查规则:
  73. package.json中eslintConfig中设置
  74. "eslintConfig": {
  75. "extends": "airbnb-base", // 继承airbnb的风格规范
  76. "env": {
  77. "browser": true // 可以使用浏览器中的全局变量(使用window不会报错)
  78. }
  79. }
  80. */
  81. test: /\.js$/,
  82. exclude: /node_modules/, // 忽略node_modules
  83. enforce: 'pre', // 优先执行
  84. loader: 'eslint-loader',
  85. options: {
  86. // 自动修复
  87. fix: true,
  88. },
  89. },
  90. /*
  91. js兼容性处理:需要下载 babel-loader @babel/core
  92. 1. 基本js兼容性处理 --> @babel/preset-env
  93. 问题:只能转换基本语法,如promise高级语法不能转换
  94. 2. 全部js兼容性处理 --> @babel/polyfill
  95. 问题:只要解决部分兼容性问题,但是将所有兼容性代码全部引入,体积太大了
  96. 3. 需要做兼容性处理的就做:按需加载 --> core-js
  97. */
  98. {
  99. // 第三种方式:按需加载
  100. test: /\.js$/,
  101. exclude: /node_modules/,
  102. loader: 'babel-loader',
  103. options: {
  104. // 预设:指示babel做怎样的兼容性处理
  105. presets: [
  106. '@babel/preset-env', // 基本预设
  107. {
  108. useBuiltIns: 'usage', //按需加载
  109. corejs: { version: 3 }, // 指定core-js版本
  110. targets: { // 指定兼容到什么版本的浏览器
  111. chrome: '60',
  112. firefox: '50',
  113. ie: '9',
  114. safari: '10',
  115. edge: '17'
  116. },
  117. },
  118. ],
  119. },
  120. },
  121. {
  122. // 图片处理
  123. test: /\.(jpg|png|gif)/,
  124. loader: 'url-loader',
  125. options: {
  126. limit: 8 * 1024,
  127. name: '[hash:10].[ext]',
  128. outputPath: 'imgs',
  129. esModule: false, // 关闭url-loader默认使用的es6模块化解析
  130. },
  131. },
  132. // html中的图片处理
  133. {
  134. test: /\.html$/,
  135. loader: 'html-loader',
  136. },
  137. // 处理其他文件
  138. {
  139. exclude: /\.(js|css|less|html|jpg|png|gif)/,
  140. loader: 'file-loader',
  141. options: {
  142. outputPath: 'media',
  143. },
  144. },
  145. ],
  146. },
  147. plugins: [
  148. new MiniCssExtractPlugin({
  149. // 对输出的css文件进行重命名
  150. filename: 'css/built.css',
  151. }),
  152. // 压缩css
  153. new OptimiziCssAssetsWebpackPlugin(),
  154. // HtmlWebpackPlugin:html文件的打包和压缩处理
  155. // 通过这个插件会自动将单独打包的样式文件通过link标签引入
  156. new HtmlWebpackPlugin({
  157. template: './src/index.html',
  158. // 压缩html代码
  159. minify: {
  160. // 移除空格
  161. collapseWhitespace: true,
  162. // 移除注释
  163. removeComments: true,
  164. },
  165. }),
  166. ],
  167. // 生产环境下会自动压缩js代码
  168. mode: 'production',
  169. }

五、Webpack 优化配置

5.1 开发环境性能优化

5.1.1 HMR(模块热替换)

HMR: hot module replacement 热模块替换 / 模块热替换
作用:一个模块发生变化,只会重新打包构建这一个模块(而不是打包所有模块) ,极大提升构建速度
代码:只需要在 devServer 中设置 hot 为 true,就会自动开启HMR功能(只能在开发模式下使用)

  1. devServer: {
  2. contentBase: resolve(__dirname, 'build'),
  3. compress: true,
  4. port: 3000,
  5. open: true,
  6. // 开启HMR功能
  7. // 当修改了webpack配置,新配置要想生效,必须重启webpack服务
  8. hot: true
  9. }

每种文件实现热模块替换的情况:

  • 样式文件:可以使用HMR功能,因为开发环境下使用的 style-loader 内部默认实现了热模块替换功能
  • js 文件:默认不能使用HMR功能(修改一个 js 模块所有 js 模块都会刷新)
    —> 实现 HMR 需要修改 js 代码(添加支持 HMR 功能的代码)

    1. // 绑定
    2. if (module.hot) {
    3. // 一旦 module.hot 为true,说明开启了HMR功能。 --> 让HMR功能代码生效
    4. module.hot.accept('./print.js', function() {
    5. // 方法会监听 print.js 文件的变化,一旦发生变化,只有这个模块会重新打包构建,其他模块不会。
    6. // 会执行后面的回调函数
    7. print();
    8. });
    9. }
  • 注意:HMR 功能对 js 的处理,只能处理非入口 js 文件的其他文件。

  • html 文件: 默认不能使用 HMR 功能(html 不用做 HMR 功能,因为只有一个 html 文件,不需要再优化)
    使用 HMR 会导致问题:html 文件不能热更新了(不会自动打包构建)
    解决:修改 entry 入口,将 html 文件引入(这样 html 修改整体刷新)

    1. entry: ['./src/js/index.js', './src/index.html']

    5.1.2 source-map

    source-map:一种提供源代码到构建后代码的映射的技术 (如果构建后代码出错了,通过映射可以追踪源代码错误)
    参数:[inline-|hidden-|eval-][nosources-][cheap-[module-]]source-map
    代码:

    1. devtool: 'eval-source-map'

    可选方案:[生成source-map的位置|给出的错误代码信息]

  • source-map:外部,错误代码准确信息 和 源代码的错误位置

  • inline-source-map:内联,只生成一个内联 source-map,错误代码准确信息 和 源代码的错误位置
  • hidden-source-map:外部,错误代码错误原因,但是没有错误位置(为了隐藏源代码),不能追踪源代码错误,只能提示到构建后代码的错误位置
  • eval-source-map:内联,每一个文件都生成对应的 source-map,都在 eval 中,错误代码准确信息 和 源代码的错误位
  • nosources-source-map:外部,错误代码准确信息,但是没有任何源代码信息(为了隐藏源代码)
  • cheap-source-map:外部,错误代码准确信息 和 源代码的错误位置,只能把错误精确到整行,忽略列
  • cheap-module-source-map:外部,错误代码准确信息 和 源代码的错误位置,module 会加入 loader 的 source-map

内联 和 外部的区别:1. 外部生成了文件,内联没有 2. 内联构建速度更快
开发/生产环境可做的选择:
开发环境:需要考虑速度快,调试更友好

  • 速度快( eval > inline > cheap >… )
    1. eval-cheap-souce-map
    2. eval-source-map
  • 调试更友好
    1. souce-map
    2. cheap-module-souce-map
    3. cheap-souce-map

最终得出最好的两种方案 —> eval-source-map(完整度高,内联速度快) / eval-cheap-module-souce-map(错误提示忽略列但是包含其他信息,内联速度快)
生产环境:需要考虑源代码要不要隐藏,调试要不要更友好

  • 内联会让代码体积变大,所以在生产环境不用内联
  • 隐藏源代码
    1. nosources-source-map 全部隐藏
    2. hidden-source-map 只隐藏源代码,会提示构建后代码错误信息

最终得出最好的两种方案 —> source-map(最完整) / cheap-module-souce-map(错误提示一整行忽略列)

5.2 生产环境性能优化

5.2.1 优化打包构建速度

5.2.1.1 oneOf

oneOf:匹配到 loader 后就不再向后进行匹配,优化生产环境的打包构建速度
代码:

  1. module: {
  2. rules: [
  3. {
  4. // js 语法检查
  5. test: /\.js$/,
  6. exclude: /node_modules/,
  7. // 优先执行
  8. enforce: 'pre',
  9. loader: 'eslint-loader',
  10. options: {
  11. fix: true
  12. }
  13. },
  14. {
  15. // oneOf 优化生产环境的打包构建速度
  16. // 以下loader只会匹配一个(匹配到了后就不会再往下匹配了)
  17. // 注意:不能有两个配置处理同一种类型文件(所以把eslint-loader提取出去放外面)
  18. oneOf: [
  19. {
  20. test: /\.css$/,
  21. use: [...commonCssLoader]
  22. },
  23. {
  24. test: /\.less$/,
  25. use: [...commonCssLoader, 'less-loader']
  26. },
  27. {
  28. // js 兼容性处理
  29. test: /\.js$/,
  30. exclude: /node_modules/,
  31. loader: 'babel-loader',
  32. options: {
  33. presets: [
  34. [
  35. '@babel/preset-env',
  36. {
  37. useBuiltIns: 'usage',
  38. corejs: {version: 3},
  39. targets: {
  40. chrome: '60',
  41. firefox: '50'
  42. }
  43. }
  44. ]
  45. ]
  46. }
  47. },
  48. {
  49. test: /\.(jpg|png|gif)/,
  50. loader: 'url-loader',
  51. options: {
  52. limit: 8 * 1024,
  53. name: '[hash:10].[ext]',
  54. outputPath: 'imgs',
  55. esModule: false
  56. }
  57. },
  58. {
  59. test: /\.html$/,
  60. loader: 'html-loader'
  61. },
  62. {
  63. exclude: /\.(js|css|less|html|jpg|png|gif)/,
  64. loader: 'file-loader',
  65. options: {
  66. outputPath: 'media'
  67. }
  68. }
  69. ]
  70. }
  71. ]
  72. },

5.2.1.2 babel 缓存

babel 缓存:类似 HMR,将 babel 处理后的资源缓存起来(哪里的 js 改变就更新哪里,其他 js 还是用之前缓存的资源),让第二次打包构建速度更快
代码:

  1. {
  2. test: /\.js$/,
  3. exclude: /node_modules/,
  4. loader: 'babel-loader',
  5. options: {
  6. presets: [
  7. [
  8. '@babel/preset-env',
  9. {
  10. useBuiltIns: 'usage',
  11. corejs: { version: 3 },
  12. targets: {
  13. chrome: '60',
  14. firefox: '50'
  15. }
  16. }
  17. ]
  18. ],
  19. // 开启babel缓存
  20. // 第二次构建时,会读取之前的缓存
  21. cacheDirectory: true
  22. }
  23. },

文件资源缓存
文件名不变,就不会重新请求,而是再次用之前缓存的资源
1.hash: 每次 wepack 打包时会生成一个唯一的 hash 值。
问题:重新打包,所有文件的 hsah 值都改变,会导致所有缓存失效。(可能只改动了一个文件)
2.chunkhash:根据 chunk 生成的 hash 值。来源于同一个 chunk的 hash 值一样
问题:js 和 css 来自同一个chunk,hash 值是一样的(因为 css-loader 会将 css 文件加载到 js 中,所以同属于一个chunk)
3.contenthash: 根据文件的内容生成 hash 值。不同文件 hash 值一定不一样(文件内容修改,文件名里的 hash 才会改变)
修改 css 文件内容,打包后的 css 文件名 hash 值就改变,而 js 文件没有改变 hash 值就不变,这样 css 和 js 缓存就会分开判断要不要重新请求资源 —> 让代码上线运行缓存更好使用

5.2.1.3 多进程打包

多进程打包:某个任务消耗时间较长会卡顿,多进程可以同一时间干多件事,效率更高。
优点是提升打包速度,缺点是每个进程的开启和交流都会有开销(babel-loader消耗时间最久,所以使用thread-loader针对其进行优化)

  1. {
  2. test: /\.js$/,
  3. exclude: /node_modules/,
  4. use: [
  5. /*
  6. thread-loader会对其后面的loader(这里是babel-loader)开启多进程打包。
  7. 进程启动大概为600ms,进程通信也有开销。(启动的开销比较昂贵,不要滥用)
  8. 只有工作消耗时间比较长,才需要多进程打包
  9. */
  10. {
  11. loader: 'thread-loader',
  12. options: {
  13. workers: 2 // 进程2个
  14. }
  15. },
  16. {
  17. loader: 'babel-loader',
  18. options: {
  19. presets: [
  20. [
  21. '@babel/preset-env',
  22. {
  23. useBuiltIns: 'usage',
  24. corejs: { version: 3 },
  25. targets: {
  26. chrome: '60',
  27. firefox: '50'
  28. }
  29. }
  30. ]
  31. ],
  32. // 开启babel缓存
  33. // 第二次构建时,会读取之前的缓存
  34. cacheDirectory: true
  35. }
  36. }
  37. ]
  38. },

5.2.1.4 externals

externals:让某些库不打包,通过 cdn 引入
webpack.config.js 中配置:

  1. externals: {
  2. // 拒绝jQuery被打包进来(通过cdn引入,速度会快一些)
  3. // 忽略的库名 -- npm包名
  4. jquery: 'jQuery'
  5. }

需要在 index.html 中通过 cdn 引入:

  1. <script src="https://cdn.bootcss.com/jquery/1.12.4/jquery.min.js"></script>

5.2.1.5 dll

dll:让某些库单独打包,后直接引入到 build 中。可以在 code split 分割出 node_modules 后再用 dll 更细的分割,优化代码运行的性能。
webpack.dll.js 配置:(将 jquery 单独打包)

  1. /*
  2. node_modules的库会打包到一起,但是很多库的时候打包输出的js文件就太大了
  3. 使用dll技术,对某些库(第三方库:jquery、react、vue...)进行单独打包
  4. 当运行webpack时,默认查找webpack.config.js配置文件
  5. 需求:需要运行webpack.dll.js文件
  6. --> webpack --config webpack.dll.js(运行这个指令表示以这个配置文件打包)
  7. */
  8. const { resolve } = require('path');
  9. const webpack = require('webpack');
  10. module.exports = {
  11. entry: {
  12. // 最终打包生成的[name] --> jquery
  13. // ['jquery] --> 要打包的库是jquery
  14. jquery: ['jquery']
  15. },
  16. output: {
  17. // 输出出口指定
  18. filename: '[name].js', // name就是jquery
  19. path: resolve(__dirname, 'dll'), // 打包到dll目录下
  20. library: '[name]_[hash]', // 打包的库里面向外暴露出去的内容叫什么名字
  21. },
  22. plugins: [
  23. // 打包生成一个manifest.json --> 提供jquery的映射关系(告诉webpack:jquery之后不需要再打包和暴露内容的名称)
  24. new webpack.DllPlugin({
  25. name: '[name]_[hash]', // 映射库的暴露的内容名称
  26. path: resolve(__dirname, 'dll/manifest.json') // 输出文件路径
  27. })
  28. ],
  29. mode: 'production'
  30. };

webpack.config.js 配置:(告诉 webpack 不需要再打包 jquery,并将之前打包好的 jquery 跟其他打包好的资源一同输出到 build 目录下)

  1. // 引入插件
  2. const webpack = require('webpack');
  3. const AddAssetHtmlWebpackPlugin = require('add-asset-html-webpack-plugin');
  4. // plugins中配置:
  5. plugins: [
  6. new HtmlWebpackPlugin({
  7. template: './src/index.html'
  8. }),
  9. // 告诉webpack哪些库不参与打包,同时使用时的名称也得变
  10. new webpack.DllReferencePlugin({
  11. manifest: resolve(__dirname, 'dll/manifest.json')
  12. }),
  13. // 将某个文件打包输出到build目录下,并在html中自动引入该资源
  14. new AddAssetHtmlWebpackPlugin({
  15. filepath: resolve(__dirname, 'dll/jquery.js')
  16. })
  17. ],

5.2.2 优化代码运行的性能

5.2.2.1 缓存

5.2.2.2 tree shaking(树摇)

tree shaking:去除无用代码
前提:1. 必须使用 ES6 模块化 2. 开启 production 环境 (这样就自动会把无用代码去掉)
作用:减少代码体积
原理:

  • ES6 Module 引入进行静态分析,故而编译的时候正确判断到底加载了那些模块
  • 静态分析程序流,判断那些模块和变量未被使用或者引用,进而删除对应代码

在 package.json 中配置:
"sideEffects": false 表示所有代码都没有副作用(都可以进行 tree shaking)
这样会导致的问题:可能会把 css/@babel/polyfill 文件干掉(副作用)
所以可以配置:"sideEffects": ["*.css", "*.less"] 不会对css/less文件tree shaking处理

5.2.2.3 code split(代码分割)

代码分割。将打包输出的一个大的 bundle.js 文件拆分成多个小文件,这样可以并行加载多个文件,比加载一个文件更快。
1.多入口拆分

  1. entry: {
  2. // 多入口:有一个入口,最终输出就有一个bundle
  3. index: './src/js/index.js',
  4. test: './src/js/test.js'
  5. },
  6. output: {
  7. // [name]:取文件名
  8. filename: 'js/[name].[contenthash:10].js',
  9. path: resolve(__dirname, 'build')
  10. },

2.optimization:

  1. optimization: {
  2. splitChunks: {
  3. chunks: 'all'
  4. }
  5. },
  • 将 node_modules 中的代码单独打包(大小超过30kb)
  • 自动分析多入口chunk中,有没有公共的文件。如果有会打包成单独一个chunk(比如两个模块中都引入了jquery会被打包成单独的文件)(大小超过30kb)

3.import 动态导入语法:

  1. /*
  2. 通过js代码,让某个文件被单独打包成一个chunk
  3. import动态导入语法:能将某个文件单独打包(test文件不会和index打包在同一个文件而是单独打包)
  4. webpackChunkName:指定test单独打包后文件的名字
  5. */
  6. import(/* webpackChunkName: 'test' */'./test')
  7. .then(({ mul, count }) => {
  8. // 文件加载成功~
  9. // eslint-disable-next-line
  10. console.log(mul(2, 5));
  11. })
  12. .catch(() => {
  13. // eslint-disable-next-line
  14. console.log('文件加载失败~');
  15. });

5.2.2.4 lazy loading(懒加载/预加载)

1.懒加载:当文件需要使用时才加载(需要代码分割)。但是如果资源较大,加载时间就会较长,有延迟。
2.正常加载:可以认为是并行加载(同一时间加载多个文件)没有先后顺序,先加载了不需要的资源就会浪费时间。
3.预加载 prefetch(兼容性很差):会在使用之前,提前加载。等其他资源加载完毕,浏览器空闲了,再偷偷加载这个资源。这样在使用时已经加载好了,速度很快。所以在懒加载的基础上加上预加载会更好。
代码:

  1. document.getElementById('btn').onclick = function() {
  2. // 将import的内容放在异步回调函数中使用,点击按钮,test.js才会被加载(不会重复加载)
  3. // webpackPrefetch: true表示开启预加载
  4. import(/* webpackChunkName: 'test', webpackPrefetch: true */'./test').then(({ mul }) => {
  5. console.log(mul(4, 5));
  6. });
  7. import('./test').then(({ mul }) => {
  8. console.log(mul(2, 5))
  9. })
  10. };

5.2.2.5 pwa(离线可访问技术)

pwa:离线可访问技术(渐进式网络开发应用程序),使用 serviceworker 和 workbox 技术。优点是离线也能访问,缺点是兼容性差。
webpack.config.js 中配置:

  1. const WorkboxWebpackPlugin = require('workbox-webpack-plugin'); // 引入插件
  2. // plugins中加入:
  3. new WorkboxWebpackPlugin.GenerateSW({
  4. /*
  5. 1. 帮助serviceworker快速启动
  6. 2. 删除旧的 serviceworker
  7. 生成一个 serviceworker 配置文件
  8. */
  9. clientsClaim: true,
  10. skipWaiting: true
  11. })

index.js 中还需要写一段代码来激活它的使用:

  1. /*
  2. 1. eslint不认识 window、navigator全局变量
  3. 解决:需要修改package.json中eslintConfig配置
  4. "env": {
  5. "browser": true // 支持浏览器端全局变量
  6. }
  7. 2. sw代码必须运行在服务器上
  8. --> nodejs
  9. 或-->
  10. npm i serve -g
  11. serve -s build 启动服务器,将打包输出的build目录下所有资源作为静态资源暴露出去
  12. */
  13. if ('serviceWorker' in navigator) { // 处理兼容性问题
  14. window.addEventListener('load', () => {
  15. navigator.serviceWorker
  16. .register('/service-worker.js') // 注册serviceWorker
  17. .then(() => {
  18. console.log('sw注册成功了~');
  19. })
  20. .catch(() => {
  21. console.log('sw注册失败了~');
  22. });
  23. });
  24. }

六、Webpack 配置详情

6.1 entry

entry: 入口起点

  1. string —> ‘./src/index.js’,单入口
    打包形成一个 chunk。 输出一个 bundle 文件。此时 chunk 的名称默认是 main
  2. array —> [‘./src/index.js’, ‘./src/add.js’],多入口
    所有入口文件最终只会形成一个 chunk,输出出去只有一个 bundle 文件。
    (一般只用在 HMR 功能中让 html 热更新生效)
  3. object,多入口
    有几个入口文件就形成几个 chunk,输出几个 bundle 文件,此时 chunk 的名称是 key 值

—> 特殊用法:

  1. entry: {
  2. // 最终只会形成一个chunk, 输出出去只有一个bundle文件。
  3. index: ['./src/index.js', './src/count.js'],
  4. // 形成一个chunk,输出一个bundle文件。
  5. add: './src/add.js'
  6. }

6.2 output

  1. output: {
  2. // 文件名称(指定名称+目录)
  3. filename: 'js/[name].js',
  4. // 输出文件目录(将来所有资源输出的公共目录)
  5. path: resolve(__dirname, 'build'),
  6. // 所有资源引入公共路径前缀 --> 'imgs/a.jpg' --> '/imgs/a.jpg'
  7. publicPath: '/',
  8. chunkFilename: 'js/[name]_chunk.js', // 指定非入口chunk的名称
  9. library: '[name]', // 打包整个库后向外暴露的变量名
  10. libraryTarget: 'window' // 变量名添加到哪个上 browser:window
  11. // libraryTarget: 'global' // node:global
  12. // libraryTarget: 'commonjs' // conmmonjs模块 exports
  13. },

6.3 module

  1. module: {
  2. rules: [
  3. // loader的配置
  4. {
  5. test: /\.css$/,
  6. // 多个loader用use
  7. use: ['style-loader', 'css-loader']
  8. },
  9. {
  10. test: /\.js$/,
  11. // 排除node_modules下的js文件
  12. exclude: /node_modules/,
  13. // 只检查src下的js文件
  14. include: resolve(__dirname, 'src'),
  15. enforce: 'pre', // 优先执行
  16. // enforce: 'post', // 延后执行
  17. // 单个loader用loader
  18. loader: 'eslint-loader',
  19. options: {} // 指定配置选项
  20. },
  21. {
  22. // 以下配置只会生效一个
  23. oneOf: []
  24. }
  25. ]
  26. },

6.4 resolve

  1. // 解析模块的规则
  2. resolve: {
  3. // 配置解析模块路径别名: 优点:当目录层级很复杂时,简写路径;缺点:路径不会提示
  4. alias: {
  5. $css: resolve(__dirname, 'src/css')
  6. },
  7. // 配置省略文件路径的后缀名(引入时就可以不写文件后缀名了)
  8. extensions: ['.js', '.json', '.jsx', '.css'],
  9. // 告诉 webpack 解析模块应该去找哪个目录
  10. modules: [resolve(__dirname, '../../node_modules'), 'node_modules']
  11. }

这样配置后,引入文件就可以这样简写:import '$css/index';

6.5 dev server

  1. devServer: {
  2. // 运行代码所在的目录
  3. contentBase: resolve(__dirname, 'build'),
  4. // 监视contentBase目录下的所有文件,一旦文件变化就会reload
  5. watchContentBase: true,
  6. watchOptions: {
  7. // 忽略文件
  8. ignored: /node_modules/
  9. },
  10. // 启动gzip压缩
  11. compress: true,
  12. // 端口号
  13. port: 5000,
  14. // 域名
  15. host: 'localhost',
  16. // 自动打开浏览器
  17. open: true,
  18. // 开启HMR功能
  19. hot: true,
  20. // 不要显示启动服务器日志信息
  21. clientLogLevel: 'none',
  22. // 除了一些基本信息外,其他内容都不要显示
  23. quiet: true,
  24. // 如果出错了,不要全屏提示
  25. overlay: false,
  26. // 服务器代理,--> 解决开发环境跨域问题
  27. proxy: {
  28. // 一旦devServer(5000)服务器接收到/api/xxx的请求,就会把请求转发到另外一个服务器3000
  29. '/api': {
  30. target: 'http://localhost:3000',
  31. // 发送请求时,请求路径重写:将/api/xxx --> /xxx (去掉/api)
  32. pathRewrite: {
  33. '^/api': ''
  34. }
  35. }
  36. }
  37. }

其中,跨域问题:同源策略中不同的协议、端口号、域名就会产生跨域。
正常的浏览器和服务器之间有跨域,但是服务器之间没有跨域。代码通过代理服务器运行,所以浏览器和代理服务器之间没有跨域,浏览器把请求发送到代理服务器上,代理服务器替你转发到另外一个服务器上,服务器之间没有跨域,所以请求成功。代理服务器再把接收到的响应响应给浏览器。这样就解决开发环境下的跨域问题。

6.6 optimization

contenthash 缓存会导致一个问题:修改 a 文件导致 b 文件 contenthash 变化。
因为在 index.js 中引入 a.js,打包后 index.js 中记录了 a.js 的 hash 值,而 a.js 改变,其重新打包后的 hash 改变,导致 index.js 文件内容中记录的 a.js 的 hash 也改变,从而重新打包后 index.js 的 hash 值也会变,这样就会使缓存失效。(改变的是a.js文件但是 index.js 文件的 hash 值也改变了)
解决办法:runtimeChunk —> 将当前模块记录其他模块的 hash 单独打包为一个文件 runtime,这样 a.js 的 hash 改变只会影响 runtime 文件,不会影响到 index.js 文件

  1. output: {
  2. filename: 'js/[name].[contenthash:10].js',
  3. path: resolve(__dirname, 'build'),
  4. chunkFilename: 'js/[name].[contenthash:10]_chunk.js' // 指定非入口文件的其他chunk的名字加_chunk
  5. },
  6. optimization: {
  7. splitChunks: {
  8. chunks: 'all',
  9. /* 以下都是splitChunks默认配置,可以不写
  10. miniSize: 30 * 1024, // 分割的chunk最小为30kb(大于30kb的才分割)
  11. maxSize: 0, // 最大没有限制
  12. minChunks: 1, // 要提取的chunk最少被引用1次
  13. maxAsyncRequests: 5, // 按需加载时并行加载的文件的最大数量为5
  14. maxInitialRequests: 3, // 入口js文件最大并行请求数量
  15. automaticNameDelimiter: '~', // 名称连接符
  16. name: true, // 可以使用命名规则
  17. cacheGroups: { // 分割chunk的组
  18. vendors: {
  19. // node_modules中的文件会被打包到vendors组的chunk中,--> vendors~xxx.js
  20. // 满足上面的公共规则,大小超过30kb、至少被引用一次
  21. test: /[\\/]node_modules[\\/]/,
  22. // 优先级
  23. priority: -10
  24. },
  25. default: {
  26. // 要提取的chunk最少被引用2次
  27. minChunks: 2,
  28. prority: -20,
  29. // 如果当前要打包的模块和之前已经被提取的模块是同一个,就会复用,而不是重新打包
  30. reuseExistingChunk: true
  31. }
  32. } */
  33. },
  34. // 将index.js记录的a.js的hash值单独打包到runtime文件中
  35. runtimeChunk: {
  36. name: entrypoint => `runtime-${entrypoint.name}`
  37. },
  38. minimizer: [
  39. // 配置生产环境的压缩方案:js/css
  40. new TerserWebpackPlugin({
  41. // 开启缓存
  42. cache: true,
  43. // 开启多进程打包
  44. parallel: true,
  45. // 启用sourceMap(否则会被压缩掉)
  46. sourceMap: true
  47. })
  48. ]
  49. }

七、Webpack5 介绍和使用

此版本重点关注以下内容:

  • 通过持久缓存提高构建性能.
  • 使用更好的算法和默认值来改善长期缓存.
  • 通过更好的树摇和代码生成来改善捆绑包大小.
  • 清除处于怪异状态的内部结构,同时在 v4 中实现功能而不引入任何重大更改.
  • 通过引入重大更改来为将来的功能做准备,以使我们能够尽可能长时间地使用 v5.

    下载

    npm i webpack@next webpack-cli -D

    自动删除 Node.js Polyfills

    早期,webpack 的目标是允许在浏览器中运行大多数 node.js 模块,但是模块格局发生了变化,许多模块用途现在主要是为前端目的而编写的。webpack <= 4 附带了许多 node.js 核心模块的 polyfill,一旦模块使用任何核心模块(即 crypto 模块),这些模块就会自动应用。
    尽管这使使用为 node.js 编写的模块变得容易,但它会将这些巨大的 polyfill 添加到包中。在许多情况下,这些 polyfill 是不必要的。
    webpack 5 会自动停止填充这些核心模块,并专注于与前端兼容的模块。
    迁移:

  • 尽可能尝试使用与前端兼容的模块。

  • 可以为 node.js 核心模块手动添加一个 polyfill。错误消息将提示如何实现该目标。

Chunk 和模块 ID
添加了用于长期缓存的新算法。在生产模式下默认情况下启用这些功能。

  1. chunkIds: "deterministic", moduleIds: "deterministic"

Chunk ID

你可以不用使用 import(/* webpackChunkName: "name" */ "module") 在开发环境来为 chunk 命名,生产环境还是有必要的
webpack 内部有 chunk 命名规则,不再是以 id(0, 1, 2)命名了

Tree Shaking

  1. webpack 现在能够处理对嵌套模块的 tree shaking

    1. // inner.js
    2. export const a = 1;
    3. export const b = 2;
    4. // module.js
    5. import * as inner from './inner';
    6. export { inner };
    7. // user.js
    8. import * as module from './module';
    9. console.log(module.inner.a);

    在生产环境中, inner 模块暴露的 b 会被删除

  2. webpack 现在能够多个模块之前的关系

    1. import { something } from './something';
    2. function usingSomething() {
    3. return something;
    4. }
    5. export function test() {
    6. return usingSomething();
    7. }

    当设置了"sideEffects": false时,一旦发现test方法没有使用,不但删除test,还会删除"./something"

  3. webpack 现在能处理对 Commonjs 的 tree shaking

    Output

    webpack 4 默认只能输出 ES5 代码
    webpack 5 开始新增一个属性 output.ecmaVersion, 可以生成 ES5 和 ES6 / ES2015 代码.
    如:output.ecmaVersion: 2015
    SplitChunk

    1. // webpack4
    2. minSize: 30000;
    3. // webpack5
    4. minSize: {
    5. javascript: 30000,
    6. style: 50000,
    7. }

    Caching

    1. // 配置缓存
    2. cache: {
    3. // 磁盘存储
    4. type: "filesystem",
    5. buildDependencies: {
    6. // 当配置修改时,缓存失效
    7. config: [__filename]
    8. }
    9. }

    缓存将存储到 node_modules/.cache/webpack

    监视输出文件

    之前 webpack 总是在第一次构建时输出全部文件,但是监视重新构建时会只更新修改的文件。
    此次更新在第一次构建时会找到输出文件看是否有变化,从而决定要不要输出全部文件。

    默认值