• vue项目：webpack打包优化实践

    本文目录

    一、项目基本信息

    本次要进行webpack优化的项目是vue2开发的，基本信息如下：
    在这里插入图片描述
    在这里插入图片描述
    vue.config.js配置如下：

    module.exports = {
  productionSourceMap: false,
  chainWebpack: config => {
    config.plugin('html').tap(args => {
      args[0].chunksSortMode = 'none';
      return args;
    });
  },
  devServer: {
    disableHostCheck: true,
    before: function(app) {
      app.get('/api/version', function(req, res) {
        res.json({
          data: 'V1.0.0',
          message: '',
          status: 0,
        });
      });
    },
    proxy: {
      '/api': {
        target: 'http://localhost:8080/',
        changeOrigin: true,
        autoRewrite: true,
        pathRewrite: {
          '^/api/': '/',
        },
      },
    },
  },
};

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31

    可以发现，这个项目基本没有做任何的优化。

    二、分析当前项目情况

    1、使用 webpack-bundle-analyzer 插件

    该插件主要是分析项目各个模块的大小。

    • 安装：npm i webpack-bundle-analyzer -D
    • 使用：
    // vue.config.js
const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;

module.exports = {
  productionSourceMap: false,
  // webpack相关配置：该对象将会被webpack-merge合并入最终的webpack配置
  configureWebpack: config => {
    config.plugins.push(new BundleAnalyzerPlugin());
  },
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    • 执行：npm run build --report
      在这里插入图片描述
      在这里插入图片描述

    • 浏览器默认打开：http://127.0.0.1:8888/ 得到
      在这里插入图片描述
      可以看到，不仅打包过程有warning，而且打包后最大的文件达竟然有4.17M！

    • new BundleAnalyzerPlugin 参数配置说明

    new BundleAnalyzerPlugin({
    analyzerMode:'server', // 可以是 server、static、json、disabled。在server模式下，分析器将启动HTTP服务器来显示软件包报告。在“静态”模式下，会生成带有报告的单个HTML文件。在disabled模式下，你可以使用这个插件来将generateStatsFile设置为true来生成Webpack Stats JSON文件。
    analyzerHost: '127.0.0.1', // 将在“服务器”模式下使用的端口启动HTTP服务器
    analyzerPort: 8888, // 端口号
    reportFilename: 'report.html', // 路径捆绑，将在static模式下生成的报告文件。相对于捆绑输出目录
    defaultSizes: 'parsed', // 默认显示在报告中的模块大小匹配方式。应该是stat，parsed或者gzip中的一个
    openAnalyzer: false, // 在默认浏览器中是否自动打开报告，默认 true
    generateStatsFile: false, // 如果为true，则Webpack Stats JSON文件将在bundle输出目录中生成
    statsFilename: 'stats.json', // 相对于捆绑输出目录
    statsOptions: null, //stats.toJson()方法的选项。例如，您可以使用source：false选项排除统计文件中模块的来源。在这里查看更多选项：https://github.com/webpack/webpack/blob/webpack-1/lib/Stats.js#L21
    logLevel: 'info', // 日志级别，可以是info, warn, error, silent
    excludeAssets:null, // 用于排除分析一些文件
})

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    2、使用 speed-measure-webpack-plugin 插件

    通过这个插件分析 webpack 的总打包耗时以及每个 plugin 和 loader 的打包耗时，从而让我们对打包时间较长的部分进行针对性优化。

    • 安装：npm i speed-measure-webpack-plugin -D
    • 使用：
    const SpeedMeasurePlugin = require('speed-measure-webpack-plugin');

module.exports = {
  productionSourceMap: false,
  // webpack相关配置：该对象将会被webpack-merge合并入最终的webpack配置
  configureWebpack: config => {
    config.plugins.push(new BundleAnalyzerPlugin());
    config.plugins.push(new SpeedMeasurePlugin());
  },
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 重新执行打包命令npm run build --report ，在控制台就能看到如下信息：
      在这里插入图片描述通过smp 日志可以看到，打包整体输出时间竟然需要将近29s！打包速度慢主要集中在eslint-loader、less-loader等一些loader中。

    但总的来说，无论是项目打包的文件大小，还是打包时间，都是无法忍受的！

    三、解决构建问题

    1、caniuse-lite 提示的问题

    在进行打包的时候，发现控制台很多提示：Building for production...Browserslist: caniuse-lite is outdated. Please run: npx update-browserslist-db@latest
    在这里插入图片描述

    • 办法1：根据日志提示的信息，caniuse lite过时了，直接按提示执行：npx update-browserslist-db@latest
      在这里插入图片描述
      caniuse-lite is outdated 仍然还有1个提示，说明其实问题并没有完全解决。

    • 方法2：直接删了 node_modules/caniuse-lite 文件夹，然后重新安装：npm i caniuse-lite -g
      在这里插入图片描述
      额。。。还是不能完全解决。

    • 办法3：先删了 node_modules/caniuse-lite 和 node_modules/browserslist 两个文件夹，然后执行：npm i caniuse-lite browserslist -D
      在这里插入图片描述
      然后执行打包命令，发现报错了！
      在这里插入图片描述
      好吧，删除了caniuse-lite 和 browserslist导致了，之前安装的 speed-measure-webpack-plugin 插件有问题，原因可能是三者之间存在某种关联关系，反正解决办法就是先删除package.json中的："speed-measure-webpack-plugin": "^1.5.0",然后重装speed-measure-webpack-plugin。
      在这里插入图片描述
      至此，终于把 caniuse-lite 过期的问题解决了。

    2、 warning 问题

    打包过程中，还发现有2个warning，必须给它解决了。
    在这里插入图片描述
    两个warning提示其实都差不多一个意思：就是文件过大的问题。

    修改vue.config.js配置：

    module.exports = {
  productionSourceMap: false,
  configureWebpack: config => {
    config.plugins.push(new BundleAnalyzerPlugin());
    config.plugins.push(new SpeedMeasurePlugin());
    // 性能提示配置
    config['performance'] = {
      hints: false, // 简单粗暴，关闭webpack的性能提示
      maxEntrypointSize: 512000, // 入口起点的最大体积，限制500kb
      maxAssetSize: 512000, // 生成文件的最大体积
    };
  },

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    执行打包命令，然后就不会再有warning提示。
    在这里插入图片描述
    接下来就可以继续进行优化了。

    四、打包速度优化

    1、修改source map

    执行打包命令后，会发现打包后每个js文件都有一个map文件。
    在这里插入图片描述
    map文件的作用在于：项目打包后，代码都是经过压缩加密的，如果运行时报错，输出的错误信息无法准确得知是哪里的代码报错。有了map就可以像未加密的代码一样，准确的输出是哪一行哪一列有错，也就是说map文件相当于是查看源码的一个东西。

    当然，这也会导致构建后的包体积会更大，所以，一般可以甚至，生产环境不用生成source map文件。

    只需要vue.config.js里面配置：module.exports = { productionSourceMap: false }

    生成map文件的包大小：
    在这里插入图片描述
    没有map文件的包大小：
    在这里插入图片描述

    2、处理 loader

    在前面的速度分析中我们已经知道了打包速度主要耗费在 loader 的处理上。所以要想提升速度，就得针对性的解决各个loader。

    // vue.config.js
module.exports = {
	// 生产环境是否生成 sourceMap 文件
	productionSourceMap: false, 
	configureWebpack: config => {
		// 新增配置
		config.module.rules.push(
	      {
	        test: /\.vue$/,
	        loader: 'vue-loader',
	        include: path.resolve('src'),
	        exclude: /node_modules/,
	      },
	      {
	        test: /\.js$/,
	        use: ['babel-loader'],
	        include: path.resolve('src'),
	        exclude: /node_modules/,
	      },
	      {
	        test: /\.less$/,
	        use: ['cache-loader'],
	        include: path.resolve('src'),
	        exclude: /node_modules/,
	      }
	    );
	}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27

    运行打包命令，速度喜人！
    在这里插入图片描述
    浏览器上，各个模块如下：
    在这里插入图片描述
    至此，其实本文的主要目的，提升webpack打包速度就算达成了，当然webpack还有很多可以优化的手段和措施。

    此时完整的vue.config.js如下：

    const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;
const SpeedMeasurePlugin = require('speed-measure-webpack-plugin');

const path = require('path');

module.exports = {
  // 生产环境是否生成 sourceMap 文件
  productionSourceMap: false, 
  configureWebpack: config => {
    // 性能配置
    config.performance = {
      hints: false, // 关闭性能提示
      maxEntrypointSize: 512000, // 入口起点的最大体积，限制500kb
      maxAssetSize: 512000, // 生成文件的最大体积
    };
    // 打包文件分析插件
    config.plugins.push(
      new BundleAnalyzerPlugin({
        openAnalyzer: true,
        analyzerPort: 8085,
      }),
      new SpeedMeasurePlugin() // 打包速度分析插件
    );
    // loader配置
    config.module.rules.push(
      {
        test: /\.vue$/,
        loader: 'vue-loader',
        include: path.resolve('src'),
        exclude: /node_modules/,
      },
      {
        test: /\.js$/,
        use: ['babel-loader'],
        include: path.resolve('src'),
        exclude: /node_modules/,
      },
      {
        test: /\.less$/,
        use: ['cache-loader'],
        include: path.resolve('src'),
        exclude: /node_modules/,
      }
    );
  },
  chainWebpack: config => {
    config.plugin('html').tap(args => {
      args[0].chunksSortMode = 'none';
      return args;
    });
  },
  devServer: {},
};

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    • 45
    • 46
    • 47
    • 48
    • 49
    • 50
    • 51
    • 52
    • 53

    接下来的优化重点阐述方案和实施，数据就不做过多对比了。

    五、webpack性能优化

    1、使用Tree Shaking

    webpack官方说明：https://www.webpackjs.com/guides/tree-shaking/

    • 修改vue.config.js
    module.exports = {
	// ...
	configureWebpack: config => {
		// ...
	    config.optimization = {
	      usedExports: true, // 设置 tree-shaking
	      // ...
	     }
	}
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 修改package.json: "sideEffects": true

    true 所有文件都不会受到 tree shaking 的影响
    false 所有文件都会受到 tree shaking 的影响
    [] 数组内的文件不受 tree shaking 的影响，其他受 tree shaking 的影响，例：[“.css", ".vue”]

    2、配置Gzip压缩

    从 webpack-bundle-analyzer 的分析结果，可以看到如果对打包的文件进行压缩，差异十分巨大，所以首先考虑优化的手段就是文件压缩。
    在这里插入图片描述
    本文中将利用 compression-webpack-plugin 插件来实现Gzip压缩。
    安装：npm i compression-webpack-plugin -D
    适用：

    const CompressionPlugin = require('compression-webpack-plugin');
module.exports = {
	// ...
	configureWebpack: config => {
		// ...
    	config.plugins.push(new CompressionPlugin()); // 开启gzip压缩
	}
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8

    配置说明：

    // 只在生产环境配置Gzip压缩
if (process.env.NODE_ENV === 'production') {
	new CompressionPlugin({
	  filename: '[path].gz[query]', // 使得多个.gz文件合并成一个文件，这种方式压缩后的文件少，建议使用，默认是：[path][base].gz
	  algorithm: 'gzip', // 默认压缩算法是gzip
	  test: /\.js$|\.css$|\.html$|\.ttf$|\.eot$|\.woff$/, // 使用正则给匹配到的文件做压缩，这里是给html、css、js以及字体（.ttf和.woff和.eot）做压缩
	  threshold: 10240, // 以字节为单位压缩超过此大小的文件，使用默认值10240吧
	  minRatio: 0.8, // 最小压缩比率，官方默认0.8
	  // 是否删除原有静态资源文件，即只保留压缩后的.gz文件，建议这个置为false，还保留源文件。以防假如出现访问.gz文件访问不到的时候，还可以访问源文件双重保障
	  deleteOriginalAssets: false
	})
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    但是要进行Gzip压缩，同时必须要服务端支持，也就是在服务器上进行配置。，

    比如：Nginx服务器可配置大概如下

    server {
	# ....
	gzip on; # 开启gzip压缩
	gzip_min_length 4k; # 小于4k的文件不会被压缩，大于4k的文件才会去压缩
	gzip_buffers 16 8k; # 处理请求压缩的缓冲区数量和大小，比如8k为单位申请16倍内存空间；使用默认即可，不用修改
	gzip_http_version 1.1; # 早期版本http不支持，指定默认兼容，不用修改
	gzip_comp_level 2; # gzip 压缩级别，1-9，理论上数字越大压缩的越好，也越占用CPU时间。实际上超过2的再压缩，只能压缩一点点了，但是cpu确是有点浪费，因为2就够用了
	 # 压缩的文件类型MIME类型
	gzip_types text/plain application/x-javascript application/javascript text/javascript text/css application/xml application/x-httpd-php image/jpeg image/gif image/png application/vnd.ms-fontobject font/x-woff font/ttf;
	gzip_vary on; # 是否在http header中添加Vary: Accept-Encoding，一般情况下建议开启   
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11

    参数详细说明：

    • gzip：是否开启gzip模块。
    • gzip_disable：指定哪些不需要gzip压缩的浏览器(将和User-Agents进行匹配)，(IE5.5和IE6 SP1使用msie6参数来禁止gzip压缩)。
    • gzip_vary：增加响应头“Vary: Accept-Encoding”。
    • gzip_proxied：Nginx做为反向代理的时候启用，

      off：关闭所有的代理结果数据压缩
      expired：如果header中包含“Expires”头信息，启用压缩·
      no-cache：如果header中包含“Cache-Control:no-cache”头信息，启用压缩
      no-store：如果header中包含“Cache-Control:no-store”头信息，启用压缩
      private：如果header中包含“Cache-Control:private”头信息，启用压缩
      no_last_modified：如果header中包含“Last_Modified”头信息，启用压缩
      no_etag：如果header中包含“ETag”头信息，启用压缩
      auth：如果header中包含“Authorization”头信息，启用压缩
      any：无条件压缩所有结果数据

    • gzip_comp_level：设置gzip压缩等级，范围是1-9，等级越低，压缩速度越快，文件压缩比越小，反之速度越慢文件压缩比越大。
    • gzip_buffers：设置用于处理请求压缩的缓冲区数量和大小。比如32 4K表示按照内存页（one memory page）大小以4K为单位（即一个系统中内存页为4K），申请32倍的内存空间。建议此项不设置，使用默认值。
    • gzip_http_version：用于识别http协议的版本，早期的浏览器不支持gzip压缩，用户会看到乱码，所以为了支持前期版本加了此选项。默认在http/1.0的协议下不开启gzip压缩。
    • gzip_types：设置需要压缩的MIME类型，如果不在设置类型范围内的请求不进行压缩。

    由于本次只是前端优化，暂时没有服务端支持，所以Gzip压缩效果暂时没办法测试。

    3、配置devtool

    在上文其实介绍过source map了，但是只是建议对生产环境不需要map文件，实际上也可以在生产环境生成map文件，那么就可以参考以下配置和说明。

    configureWebpack: config => {
	// ...
	if (process.env.NODE_ENV === 'production') {
	  // 生产环境
      config['devtool'] = 'source-map'; // 整个source map作为一个单独的文件生成。为bundle添加了一个引用注释，以便开发工具知道在哪里可以找到它。
    } else {
      // 非生产环境
      config['devtool'] = 'eval';
    }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    配置说明：

    （开发环境的配置）

    • eval：每个模块都使用eval()执行，并且都有//@ sourceURL。此选项会非常快地构建。主要缺点是，由于会映射到转换后的代码，而不是映射到原始代码（没有从 loader 中获取 source map），所以不能正确的显示行数。
    • eval-source-map：每个模块使用eval()执行，并且 source map 转换为 DataUrl 后添加到eval()中。初始化 source map 时比较慢，但是会在重新构建时提供比较快的速度，并且生成实际的文件。行数能够正确映射，因为会映射到原始代码中。它会生成用于开发环境的最佳品质的 source map。
    • cheap-eval-source-map：类似eval-source-map，每个模块使用eval()执行。这是 “cheap(低开销)” 的 source map，因为它没有生成列映射(column mapping)，只是映射行数。它会忽略源自 loader 的 source map，并且仅显示转译后的代码，就像evaldevtool。
    • cheap-module-eval-source-map：类似cheap-eval-source-map，并且，在这种情况下，源自 loader 的 source map 会得到更好的处理结果。然而，loader source map 会被简化为每行一个映射(mapping)。

    （生产环境的配置）

    • none:（省略devtool选项）不生成 source map。这是一个不错的选择。
    • source-map：整个 source map 作为一个单独的文件生成。它为 bundle 添加了一个引用注释，以便开发工具知道在哪里可以找到它。
    • hidden-source-map：与source-map相同，但不会为 bundle 添加引用注释。如果你只想 source map 映射那些源自错误报告的错误堆栈跟踪信息，但不想为浏览器开发工具暴露你的 source map，这个选项会很有用。
    • nosources-source-map：创建的 source map 不包含sourcesContent(源代码内容)。它可以用来映射客户端上的堆栈跟踪，而无须暴露所有的源代码。你可以将 source map 文件部署到 web 服务器。

    更多可查看官方：https://webpack.js.org/configuration/devtool/

    4、适用 uglifyjs-webpack-plugin 压缩js

    安装：npm install uglifyjs-webpack-plugin --save-dev
    使用：

    const UglifyJsPlugin = require('uglifyjs-webpack-plugin');
module.exports = {
    config.plugins.push(
    	new UglifyJsPlugin({
        uglifyOptions: {
          compress: {
            drop_debugger: true,
            drop_console: true, // 生产环境自动删除console
          },
          warnings: false,
        },
        sourceMap: false,
        parallel: true, // 使用多进程并行运行来提高构建速度。默认并发运行数：os.cpus().length - 1。
      })
  )
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16

    官方更多字段说明：https://www.npmjs.com/package/uglifyjs-webpack-plugin?activeTab=readme

    5、chunks 分割

    module.exports = {
	configureWebpack: config => {
		config.optimization = {
	      // 设置 tree-shaking
	      usedExports: true, 
	      // 抽离公共的代码
	      splitChunks: {
	        chunks: 'all',
	        cacheGroups: {
	          common: {
	            name: 'common', // 指定chunks名称
	            minChunks: 1,
	            test: /[\\/]node_modules[\\/]vue[\\/]|[\\/]node_modules[\\/]vue-router[\\/]|[\\/]node_modules[\\/]vuex[\\/]|[\\/]node_modules[\\/]axios[\\/]/,
	            chunks: 'initial', // 仅限于最初依赖的第三方
	            priority: -1, // 优先级：数字越大优先级越高，默认值为0，自定义的一般是负数形式，决定cacheGroups中相同条件下每个组执行的优先顺序。
	          },
	          elementUI: {
	            name: 'elementUI',
	            minChunks: 1,
	            test: /[\\/]node_modules[\\/]_?element-ui[\\/]/,
	            chunks: 'initial',
	            priority: -2,
	            reuseExistingChunk: true,
	            enforce: true,
	          },
	        },
	      },
	    };
	}
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30

    splitChunks字段说明：

    chunks: "async",  // 需要进行分割的chunks，可选值有：async，initial和all
minSize: 30000, // 新分离出的chunk必须大于等于minSize，默认为30000，约30kb。
minChunks: 1, //  一个模块至少应被minChunks个chunk所包含才能分割。默认为1。
maxAsyncRequests: 5, //  按需加载文件时，并行请求的最大数目。默认为5。
maxInitialRequests: 3, //  加载入口文件时，并行请求的最大数目。默认为3。
automaticNameDelimiter: '~', //  拆分出的chunk的名称连接符。默认为~。如chunk~vendors.js
name: true, // 设置chunk的文件名。默认为true。当为true时，splitChunks基于chunk和cacheGroups的key自动命名。
cacheGroups: {
	// cacheGroups 下可以可以配置多个组，每个组根据test设置条件，符合test条件的模块，就分配到该组。
	// 模块可以被多个组引用，但最终会根据priority来决定打包到哪个组中。
	// 默认将所有来自 node_modules目录的模块打包至vendors组，将两个以上的chunk所共享的模块打包至default组。
    vendors: {
        test: /[\\/]node_modules[\\/]/,
        priority: -10
    },
default: {
        minChunks: 2,
        priority: -20,
        reuseExistingChunk: true
    }
}

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21

    webpack优化的措施还有使用CDN、使用缓存、设置预解析、优化图片/字体等等。

    没有绝对的优化措施，只有适合的方案， 性能优化之路漫漫～

  • 相关阅读:
    Redis面试
    QT实现截屏
    vue3+koa+axios实现前后端通信
    做废20个账号才总结出的短视频运营干货
    通过DSSM算法进行商品推荐 代码+数据
    【windows|012】光猫、路由器、交换机详解
    【SSM】SpringMVC系列——SpringMVC注解式开发1
    java毕业设计——基于java+J2EE+sqlserver的音像店租赁管理系统设计与实现（毕业论文+程序源码）——租赁管理系统
    SparkSQL on K8s 在网易传媒的落地实践
    [数据结构＋算法]关于动态规划dp入门--01背包问题
  • 原文地址：https://blog.csdn.net/ganyingxie123456/article/details/136617519