webpack5配置解析

webpack

  • 配置文件 webpack.config.js
  • entry output loader plugins mode
  • webpack 命令即可打包

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

    --> 特殊用法
      {
        // 所有入口文件最终只会形成一个chunk, 输出出去只有一个bundle文件。
        index: ['./src/index.js', './src/count.js'],
        // 形成一个chunk,输出一个bundle文件。
        add: './src/add.js'
      }

output

  output: {
    // 文件名称(指定名称+目录)
    filename: 'js/[name].js',
    // 输出文件目录(将来所有资源输出的公共目录)
    path: resolve(__dirname, 'build'),
    // 所有资源引入公共路径前缀 --> 'imgs/a.jpg' --> '/imgs/a.jpg'
    publicPath: '/',
    chunkFilename: 'js/[name]_chunk.js', // 非入口chunk的名称
    // library: '[name]', // 整个库向外暴露的变量名
    // libraryTarget: 'window' // 变量名添加到哪个上 browser
    // libraryTarget: 'global' // 变量名添加到哪个上 node
    // libraryTarget: 'commonjs'
  },

module

module.exports = {
  module: {
    rules: [
      // loader的配置
      {
        test: /\.css$/,
        // 多个loader用use
        use: ['style-loader', 'css-loader']
      },
      {
        test: /\.js$/,
        // 排除node_modules下的js文件
        exclude: /node_modules/,
        // 只检查 src 下的js文件
        include: resolve(__dirname, 'src'),
        // 优先执行
        enforce: 'pre',
        // 延后执行
        // enforce: 'post',
        // 单个loader用loader
        loader: 'eslint-loader',
        options: {}
      },
      {
        // 以下配置只会生效一个
        oneOf: []
      }
    ]
  }
};

resolve

module.exports = {
  // 解析模块的规则
  resolve: {
    // 配置解析模块路径别名: 优点简写路径 缺点路径没有提示
    alias: {
      $css: resolve(__dirname, 'src/css')
    },
    // 配置省略文件路径的后缀名
    extensions: ['.js', '.json', '.jsx', '.css'],
    // 告诉 webpack 解析模块是去找哪个目录
    modules: [resolve(__dirname, '../../node_modules'), 'node_modules']
  }

  // index.js
  import '$css/index';
};

webpack.config.js

  • 作用: 指示 webpack 干哪些活(当你运行 webpack 指令时,会加载里面的配置)
  • 所有构建工具都是基于 nodejs 平台运行的~模块化默认采用 commonjs。
  • loader: 1.下载 2.使用(配置 loader)
  • plugins:1.下载 2.引入 3.使用

打包样式资源

  • sass 配置
  npm i node-sass sass-loader -D
  import './index.scss'
  {
     test:/\.(sass|scss)$/,
     use:['style-loader','css-loader','sass-loader']
  }
  • less 配置
  npm i style-loader css-loader less less-loader -D
  import './index.less'
  {
    test:/\.less$/,
    use:['style-loader','css-loader','less-loader']
  }
  • loader 配置
// resolve用来拼接绝对路径的方法
const { resolve } = require('path')

module.exports = {
  // webpack配置
  // 入口起点
  entry: './src/index.js',
  output: {
    // 输出文件名
    filename: 'index.js',
    // 输出路径 __dirname nodejs的变量,代表当前文件的目录绝对路径
    path: resolve(__dirname, 'build'),
  },
  // loader的配置
  module: {
    rules: [
      // 详细loader配置
      {
        // 匹配哪些文件
        test: /\.css$/,
        // 使用哪些loader进行处理
        use: [
          // use数组中loader执行顺序:从右到左,从下而上,依次执行
          // 创建style标签,将js中的样式资源插入进行,添加到head中生效
          'style-loader',
          // 将css文件变成common.js模块加载js中,里面的内容是样式字符串
          'css-loader',
        ],
      },
      {
        test: /\.(sass|scss)$/,
        use: [
          { loader: 'style-loader' },
          { loader: 'css-loader' },
          { loader: 'sass-loader' }],
      },
      {
        test: /\.less$/,
        use: ['style-loader', 'css-loader', 'less-loader'],
      },
    ],
  },
  // plugins的配置
  plugins: [],
  // 模式
  mode: 'development',
  // mode:'production'
}

打包 html 资源

npm i html-webpack-plugin -D
const HtmlWebpackPlugin = require('html-webpack-plugin')
module.exports = {
  entry: './src/index.js',
  output: {
    filename: 'index.js',
    path: resolve(__dirname, 'build'),
  },
  module: {
    rules: [],
  },
  plugins: [
    new HtmlWebpackPlugin({
      template:'./src/index.html'
    })
  ],
  mode: 'development',
}

打包图片资源

npm i url-loader file-loader -D
npm i html-withimg-loader -D
module.exports = {
  module: {
    rules: [
      {
        /*
          处理不了html中的img图片 需要用html-loader
        */
        test: /\.(jpg|png|gif)$/,
        // 使用一个loader  url-loader依赖file-loader
        loader: 'url-loader',
        options: {
          /*
            图片小于12kb,会被base64处理
            优点:减少请求数量(减轻服务器压力)
            缺点:图片体积会更大(文件请求速度更慢)
          */
          limit: 12 * 1024,
          /*
            问题:url-loader默认使用es6模块化解析,而html-withimg引入图片是common.js
            解析时会出现问题:[object Module]
            解决:关闭url-loader的es6模块化,使用common.js解析
          */
          esModule: false,
          name: 'images/[hash:8][name].[ext]',
        },
      },
      {
        test: /\.html$/,
        // loader: 'html-loader',
        // !!!!!注意:webpack5需要用html-withimg-loader打包才能显示
        loader: 'html-withimg-loader',
      },
    ],
  },
  plugins: [
    new HtmlWebpackPlugin({
      template:'./src/index.html'
    })
  ],
  mode: 'development',
}

打包其他资源

npm i file-loader -D
module.exports = {
  module: {
    rules: [
      // 打包其他资源(除了html/js/css资源以外的资源)
      {
        // 排除html/js/css资源
        exclude:/\.(html|js|css|scss|sass)$/,
        loader: 'file-loader',
        options:{
          name:'[hash:8].[ext]'
        }
      },
    ],
  },
  plugins: [
    new HtmlWebpackPlugin({
      template:'./src/index.html'
    })
  ],
  mode: 'development',
}

devServer

const { resolve } = require('path');
module.exports = {
  mode: 'development',
  // 设置开发服务器
  devServer: {
    // 只会在内存中编译打包,不会有任何输出文件,终止运行会删除内存
    // 开发时可直接访问到 ./build 下的静态资源,这些资源在开发中不必打包
    // 运行代码的目录
    contentBase: resolve(__dirname, 'build'),
    // 监视 contentBase 目录下的所有文件,一旦文件变化就会 reload
    watchContentBase: true,
    watchOptions: {
      // 忽略文件
      ignored: /node_modules/,
    },
    // 启动gzip压缩
    compress: true,
    // 端口号
    port: 5000,
    // 域名
    host: 'localhost',
    // 自动打开浏览器
    open: true,
    // 开启HMR功能
    hot: true,
    // 不要显示启动服务器日志信息
    clientLogLevel: 'none',
    // 除了一些基本启动信息以外,其他内容都不要显示
    quiet: true,
    // 如果出错了,不要全屏提示~
    overlay: false,
    // 服务器代理 --> 解决开发环境跨域问题
    proxy: {
      // 一旦devServer(5000)服务器接受到 /api/xxx 的请求,就会把请求转发到另外一个服务器(3000)
      '/api': {
        target: 'http://localhost:3000',
        // 发送请求时,请求路径重写:将 /api/xxx --> /xxx (去掉/api)
        pathRewrite: {
          '^/api': '',
        },
      },
    },
  },
};

提取 css 成单独文件

npm i mini-css-extract-plugin -D
module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          // 创建style标签,将样式放入
          // 'style-loader',
          // 取代style-loader,提取js中的css成单独文件
          MiniCssExtractPlugin.loader,
          // 将css文件整合到js文件中
          'css-loader',
        ],
      },
    ],
  },
  plugins: [
    new MiniCssExtractPlugin({
      filename:'css/index.css'
    })
  ],
  mode: 'development',
}

css 兼容性处理

  1. npm i postcss postcss-loader postcss-preset-env -D
  'css-loader',
  // 一般兼容靠loader,压缩靠plugins
  // 添加兼容样式
  {
    loader: 'postcss-loader',
    options: {
      postcssOptions: {
        plugins: ['postcss-preset-env'],
      },
    },
  },
  ],
  1. 在 package.json 中添加 browseslist
// 默认是生产环境,开发环境需要设置环境标量 process.env.NODE_ENV ='development'
"browserslist": {
  "development": [
  "last 1 chrome version",
  "last 1 firefox version",
  "last 1 safari version"
  ],
  "production": [
  ">0.2%",
  "not dead",
  "not op_mini all"
  ]
},
  1. 也可以新建.browserslistrc 文件配置兼容性
[production]

> 0.2%
> not dead
> not op_mini all

[development]
last 1 chorme version
last 1 firefox version
last 1 safari version

压缩 css

npm i css-minimizer-webpack-plugin -D
const CssMinimizerWebpackPlugin = require('css-minimizer-webpack-plugin');
module.exports = {
  plugins: [
    new CssMinimizerWebpackPlugin(),
  ],
  mode: 'development',
}

js 语法检查 eslint

  1. eslint 包
npm i eslint-loader eslint -D
  1. eslint 格式标准选了 airbnb
npm eslint eslint-config-airbnb-base eslint-plugin-import -D
  1. 配置
  • package.json
  "eslintConfig": {
    "extends": "airbnb-base",
    "env": {
      "browser": true
    }
  },
  "sideEffects": [
    "*.css",
    "*.less",
    "*.scss"
  ]
  • 或创建 .eslintrc 文件
{
  "extends": "airbnb-base",
  "env": {
    "browser": true
  },
  "rules": {
    "no-console": 0 // 不禁用console
  }
}
  1. 调用
{
  test: /\.js$/,
  exclude: /node_modules/,
  loader: 'eslint-loader',
  options: {
    fix: true,
  },
},

js 兼容性处理

  1. 安装开发依赖处理兼容问题 es6->es5
 npm i babel-loader @babel/core @babel/preset-env -D
  1. 处理全部 js 兼容问题 es7 等更高级语法
npm i @babel/polyfill -S

// 入口文件引入即可
import '@babel/polyfill';

  1. 按需引入
npm i core-js -S
  1. 调用
  • rules 配置
  /**
    * js兼容性处理:babel-loader @babel/core @babel/preset-env
    * 1. 基本js兼容性处理 --> @babel/preset-env
    *    问题:只能转换基本语法,如promise不能转换
    * 2. 全部兼容性处理 --> @babel/polyfill
    *    问题:我只要解决部分兼容性问题,但是将所有兼容性代码全部引入,体积太大了
    * 3. 需要做兼容性处理的就做:按需加载 --> core-js
    *
    */
  {
    test: /\.js$/,
    exclude: /node_modules/,
    loader: 'babel-loader',
    presets: [
      [
        '@babel/preset-env',
        {
          targets: {
            ie: 9,
            edge: 17,
            firefox: 60,
            chrome: 60,
            safari: 10,
          },
          useBuiltIns: 'usage',
          corejs: 3,
        },
      ],
    ],
  }
  • 或者设置配置文件 .babelrc
{
  "presets": [
    [
      "@babel/preset-env",
      {
        // 需要兼容到以下浏览器的什么版本(可不填)
        "targets": {
          "ie": 7,
          "edge": "17",
          "firefox": "60",
          "chrome": "60",
          "safari": "10"
        },
        "useBuiltIns": "usage", // 这里配置usage 会自动根据你使用的方法以及你配置的浏览器支持版本引入对于的方法。
        "corejs": 3 // 指定 corejs 版本
      }
    ]
  ]
}

压缩 html 和 js

const { resolve } = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  plugins: [
    new HtmlWebpackPlugin({
      template: './src/index.html',
      // 压缩html代码 webpack5 不用配置了
      minify: {
        // 移除空格
        collapseWhitespace: true,
        // 移除注释
        removeComments: true,
      },
    }),
  ],
  // 生产环境下自动压缩代码
  mode: 'production',
};

HMR

const { resolve } = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
process.env.NODE_ENV = 'development';
module.exports = {
  /**
   * HMR: hot module replacement 热模块替换 / 模块热替换
   *  作用:一个模块发生变化,只会重新打包这一个模块(而不是打包所有模块)
   *    极大提升构建速度
   *
   *    样式文件:可以使用HMR功能:因为style-loader内部实现了
   *    js文件:默认不能使用HMR功能
   *    html文件:默认不能使用HMR功能,同时会导致问题:html文件不能热更新了~ (就一个文件不用做HMR功能)
   *      解决:修改entry入口,将html文件引入
   */
  // 解决webpack5 HMR不更新的问题 target: 'web',
  target: process.env.NODE_ENV === 'development' ? 'web' : 'browserslist',
  entry: ['./src/js/index.js', './src/index.html'],
  output: {
    filename: 'js/index.js',
    path: resolve(__dirname, 'build'),
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: ['style-loader', 'css-loader'],
      },
      {
        test: /\.less$/,
        use: ['style-loader', 'css-loader', 'less-loader'],
      },
      {
        test: /\.(sass|scss)$/,
        use: ['style-loader', 'css-loader', 'sass-loader'],
      },
      {
        test: /\.(jpg|jpeg|png|gif)$/,
        loader: 'url-loader',
        options: {
          esModule: false,
          outputPath: 'image',
          limit: 10 * 1024,
          name: '[hash:8][name].[ext]',
        },
      },
      {
        test: /\.html$/,
        loader: 'html-withimg-loader',
      },
      {
        exclude: /\.(html|js|css|less|sass|scss|jpg|jpeg|png|gif)$/,
        loader: 'file-loader',
        options: {
          outputPath: 'media',
          name: '[hash:10].[ext]',
        },
      },
    ],
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: './src/index.html',
    }),
  ],
  mode: 'development',
  devServer: {
    contentBase: resolve(__dirname, 'build'),
    compress: true,
    open: true,
    port: 3000,
    hot: true,
  },
};

source-map

const { resolve } = require('path');
process.env.NODE_ENV = 'development';
module.exports = {
  mode: 'development',
  /* 开发阶段:推荐使用 source-map或者cheap-module-source-map,这分别是vue和react使用的值,可以获取调试信息,方便快速开发
    测试阶段:推荐使用 source-map或者cheap-module-source-map,测试阶段我们也希望在浏览器下看到正确的错误提示
    发布阶段:false、缺省值(不写) */
  devtool: 'cheap-module-source-map',
};

oneOf

module.exports = {
  module: {
    rules: [
      {
        test: /\.js$/,
        enforce: 'pre',
        exclude: /node_modules/,
        use: [
          {
            loader: 'eslint-loader',
            options: {
              fixe: true,
            },
          },
        ],
      },
      {
        // 以下loader只会匹配一个
        // 注意:不能有两个配置处理同一种类型文件
        oneOf: [
          {
            test: /\.css$/,
            use: [...commonCssLoader],
          },
          {
            test: /\.less$/,
            use: [...commonCssLoader, 'less-loader'],
          },
          {
            test: /\.(sass|scss)$/,
            use: [...commonCssLoader, 'sass-loader'],
          },
          /*
            正常来讲,一个文件只能被一个loader处理。
            当一个文件要被多个loader处理,那么一定要指定loader执行的先后顺序:
              先执行eslint 在执行babel
          */
          {
            test: /\.js$/,
            exclude: /node_modules/,
            loader: 'babel-loader',
            options: {
              presets: [
                [
                  '@babel/preset-env',
                  {
                    targets: {
                      ie: 10,
                      edge: 17,
                      firefox: 60,
                      chrome: 60,
                      safari: 10,
                    },
                    useBuiltIns: 'usage',
                    corejs: 3,
                  },
                ],
              ],
            },
          },
          {
            test: /\.(jpg|jpeg|png|gif)$/,
            loader: 'url-loader',
            options: {
              esModule: false,
              outputPath: 'image',
              limit: 10 * 1024,
              name: '[hash:8].[ext]',
            },
          },
          {
            test: /\.html$/,
            loader: 'html-withimg-loader',
          },
          {
            exclude: /\.(html|js|css|less|sass|scss|jpg|jpeg|png|gif)$/,
            loader: 'file-loader',
            options: {
              outputPath: 'media',
              name: '[hash:10].[ext]',
            },
          },
        ],
      },
    ],
  },
  mode: 'production',
};

缓存


/*
  缓存:
    babel缓存
      cacheDirectory: true
      --> 让第二次打包构建速度更快
    文件资源缓存
      hash: 每次wepack构建时会生成一个唯一的hash值。
        问题: 因为js和css同时使用一个hash值。
          如果重新打包,会导致所有缓存失效。(可能我却只改动一个文件)
      chunkhash:根据chunk生成的hash值。如果打包来源于同一个chunk,那么hash值就一样
        问题: js和css的hash值还是一样的
          因为css是在js中被引入的,所以同属于一个chunk
      contenthash: 根据文件的内容生成hash值。不同文件hash值一定不一样
      --> 让代码上线运行缓存更好使用
*/

// 定义nodejs环境变量:决定使用browserslist的哪个环境
process.env.NODE_ENV = 'production';
module.exports = {
  module: {
    rules: [
      {
        // 在package.json中eslintConfig --> airbnb
        test: /\.js$/,
        exclude: /node_modules/,
        // 优先执行
        enforce: 'pre',
        loader: 'eslint-loader',
        options: {
          fix: true
        }
      },
      {
        // 以下loader只会匹配一个
        // 注意:不能有两个配置处理同一种类型文件
        oneOf: [
          {
            test: /\.css$/,
            use: [...commonCssLoader]
          },
          {
            test: /\.less$/,
            use: [...commonCssLoader, 'less-loader']
          },
          /*
            正常来讲,一个文件只能被一个loader处理。
            当一个文件要被多个loader处理,那么一定要指定loader执行的先后顺序:
              先执行eslint 在执行babel
          */
          {
            test: /\.js$/,
            exclude: /node_modules/,
            loader: 'babel-loader',
            options: {
              presets: [
                [
                  '@babel/preset-env',
                  {
                    useBuiltIns: 'usage',
                    corejs: { version: 3 },
                    targets: {
                      chrome: '60',
                      firefox: '50'
                    }
                  }
                ]
              ],
              // 开启babel缓存
              // 第二次构建时,会读取之前的缓存
              cacheDirectory: true
            }
          },
          {
            test: /\.(jpg|png|gif)/,
            loader: 'url-loader',
            options: {
              limit: 8 * 1024,
              name: '[hash:10].[ext]',
              outputPath: 'imgs',
              esModule: false
            }
          },
          {
            test: /\.html$/,
            loader: 'html-loader'
          },
          {
            exclude: /\.(js|css|less|html|jpg|png|gif)/,
            loader: 'file-loader',
            options: {
              outputPath: 'media'
            }
          }
        ]
      }
    ]
  },
  plugins: [
    new MiniCssExtractPlugin({
      filename: 'css/built.[contenthash:10].css'
    }),
    new OptimizeCssAssetsWebpackPlugin(),
    new HtmlWebpackPlugin({
      template: './src/index.html',
      minify: {
        collapseWhitespace: true,
        removeComments: true
      }
    })
  ],
  mode: 'production',
  devtool: 'source-map'
};

tree shaking 树摇

/*
  tree shaking:去除无用代码
    前提:1. 必须使用ES6模块化  2. 开启production环境
    作用: 减少代码体积

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

// 定义nodejs环境变量:决定使用browserslist的哪个环境
process.env.NODE_ENV = 'production';

code split 代码分割

const { resolve } = require('path')
const HtmlWebpackPlugin = require('html-webpack-plugin')

module.exports = {
  // 单入口
  entry: './src/js/index.js',
  // 多入口:有一个入口,最终输出就有一个bundle(束)
  // entry: {
  //   index: './src/js/index.js',
  //   test: './src/js/test.js',
  // },
  plugins: [
    new HtmlWebpackPlugin({
      template: './src/index.html',
      minify: {
        collapseWitespace: true,
        removeComment: true,
      },
    }),
  ],
  /*
    1. 可以将node_modules中代码单独打包一个chunk最终输出
    2. 自动分析多入口chunk中,有没有公共的文件。如果有会打包成单独一个chunk
  */
  optimization: {
    splitChunks: {
      chunks: 'all',
    },
  },
  mode: 'production',
}
/*
  通过js代码,让某个文件被单独打包成一个chunk
  import动态导入语法:能将某个文件单独打包
  webpackChunkName: 'test' 重命名
*/
// import('./test').then((res) => {console.log(res)}).catch(() => {})
import(/* webpackChunkName: 'test' */ './test')
  .then(({ mul, count }) => {
    // 文件加载成功
    // eslint-disable-next-line
    console.log(mul(2, 3));
  })
  .catch(() => {
    // eslint-disable-next-line
    console.log('文件加载失败~');
  });

lazy loading 懒加载和预加载

// 懒加载~:当文件需要使用时才加载~
// 预加载 prefetch:会在使用之前,提前加载js文件
// 正常加载可以认为是并行加载(同一时间加载多个文件)
// 预加载 prefetch:等其他资源加载完毕,浏览器空闲了,再偷偷加载资源
document.getElementById('btn').onclick = function () {
  import(/* webpackChunkName: 'test', webpackPrefetch: true */ './test').then(({ mul }) => {
    console.log(mul(4, 5));
  });
};

PWA 离线访问

npm i workbox-webpack-plugin -D
/*
  PWA: 渐进式网络开发应用程序(离线可访问)
    workbox --> workbox-webpack-plugin
*/
const WorkboxWebpackPlugin = require('workbox-webpack-plugin');
process.env.NODE_ENV = 'production';
module.exports = {
  plugins: [
    new WorkboxWebpackPlugin.GenerateSW({
      /*
        1. 帮助serviceworker快速启动
        2. 删除旧的 serviceworker

        生成一个 serviceworker 配置文件~
      */
      clientsClaim: true,
      skipWaiting: true,
    }),
  ],
  mode: 'production',
  devtool: 'source-map',
};
/*
  1. eslint不认识 window、navigator全局变量
    解决:需要修改package.json中eslintConfig配置
      "env": {
        "browser": true // 支持浏览器端全局变量
      }
   2. sw代码必须运行在服务器上
      --> nodejs
      -->
        npm i serve -g
        serve -s build 启动服务器,将build目录下所有资源作为静态资源暴露出去
*/
// 注册serviceWorker
// 处理兼容性问题
if ('serviceWorker' in navigator) {
  window.addEventListener('load', () => {
    navigator.serviceWorker
      .register('/service-worker.js')
      .then(() => {
        console.log('sw注册成功了~');
      })
      .catch(() => {
        console.log('sw注册失败了~');
      });
  });
}

多进程打包

npm i thread-loader -S
/*
  开启多进程打包。
  进程启动大概为600ms,进程通信也有开销。
  只有工作消耗时间比较长,才需要多进程打包
*/
{
  loader: 'thread-loader',
  options: {
    workers: 2 // 进程2个
  }
},
{
  loader: 'babel-loader',
  options: {
    presets: [
      [
        '@babel/preset-env',
        {
          useBuiltIns: 'usage',
          corejs: { version: 3 },
          targets: {
            chrome: '60',
            firefox: '50'
          }
        }
      ]
    ],
    // 开启babel缓存
    // 第二次构建时,会读取之前的缓存
    cacheDirectory: true
  }
}

externals 引入外链拒绝打包模块

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

module.exports = {
  mode: 'production',
  externals: {
    // 拒绝jQuery被打包进来
    jquery: 'jQuery'
  }
};

dll 配置打包文件,告诉 webpack 哪些库不参与打包

  • webpack.dll.js
/**
 * 使用dll技术,对某些库(第三方库:jquery、react、vue...)进行单独打包
 * 当你运行webpack时,默认查找 webpack.config.js 配置文件
 * 需求:需要运行 webpack.dll.js 文件
 * --> webpack --config webpack.dll.js
 */
const { resolve } = require('path');
const webpack = require('webpack');

module.exports = {
  // 打包出来的dll文件将细化到每个入口名称
  // entry: {
  //   // 最终打包生成的[name] --> jquery
  //   // ['jquery'] --> 要打包的库是jquery
  //   jquery: ['jquery'],
  //   lodash: ['lodash'],
  // },
  // 打包后,dll下只有一个文件,所有第三方包都打包进vendors.js
  entry: {
    vendors: ['jquery', 'lodash'],
  },
  output: {
    filename: '[name].js', // 文件名[name]指入口中的vendors
    path: resolve(__dirname, 'dll'),
    library: '[name]_[hash:6]', // 打包的库里面向外暴露出去的内容的名字
  },
  plugins: [
    // 打包生成一个 mainfest.json --> 提供和vendors映射
    new webpack.DllPlugin({
      name: '[name]_[hash:6]', // 映射的暴露的内容名称,和output.library保持一致
      path: resolve(__dirname, 'dll/[name].manifest.json'), // 输出映射文件
    }),
  ],
  mode: 'production',
};

  • webpack.config.js
const { resolve } = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const webpack = require('webpack');
const AddAssetHtmlWebpackPlugin = require('add-asset-html-webpack-plugin');
// const fs = require('fs');
/* //由于使用entry1写法,将在dll中生成很多不同的第三方包,在通过DllReferencePlugin,AddAssetHtmlPlugin这两个插件引入到项目的js/html文件中,需要额外设置
const files = fs.readdirSync(resolve(__dirname, './dll'));
//用于存储DllReferencePlugin插件的配置,只能引入对象
const dllReferenceFiles = [];
//用于存储AddAssetHtmlPlugin插件的配置,
const htmlAssetFiles = [];
files.forEach(file => {
  //匹配jquery.js引入
  if (/.*\.js$/.test(file)) {
    htmlAssetFiles.push({ filepath: resolve(__dirname, './dll', file) });
  }
  //匹配jquery.manifest.json
  if (/.*\.manifest.json$/.test(file)) {
    dllReferenceFiles.push({ manifest: resolve(__dirname, './dll', file) });
  }
});
console.log(htmlAssetFiles, dllReferenceFiles); */

module.exports = {
  entry: './src/js/index.js',
  output: {
    // filename: 'js/[name].js',//开发环境使用该输出文件名
    filename: 'js/[name].[contenthash:4].js', //生产环境打包使用该输出文件名,可以有效利用浏览器缓存
    path: resolve(__dirname, 'build'),
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: './src/index.html',
    }),
    // 告诉webpack哪些库不参与打包,同时使用时的名称也得变~
    new webpack.DllReferencePlugin({
      manifest: resolve(__dirname, 'dll/vendors.manifest.json'),
    }),
    // 将某个文件打包输出去,并在html中自动移入该资源(报错就手动引)
    new AddAssetHtmlWebpackPlugin({
      filepath: resolve(__dirname, 'dll/vendors.js'),
    }),
    // ...dllReferenceFiles.map(obj => new webpack.DllReferencePlugin(obj)),
    // new AddAssetHtmlWebpackPlugin(htmlAssetFiles),
  ],
  mode: 'production',
  devtool: 'source-map',
};

小结

编辑不易,转载请注明出处。感谢赏阅,期待你的建议,点赞和关注。

上一篇:【webpack5修行之道】第17篇:性能优化-dll打包


下一篇:webpack5搭建vue3教-基础篇