webpack-bundle-analyzer可视化打包文件分析工具的安装使用

2,469 阅读2分钟

1 安装依赖

  • 首先安装webpack-bundle-analyzer

npm install --save-dev webpack-bundle-analyzer

  • 大多数情况下,在windows平台下使用类似于: NODE_ENV=production的命令行指令会卡住 cross-env能跨平台地设置及使用环境变量

npm install --save-dev cross-env

2 配置webpack.config.js文件

在webpack.config.js中配置以下代码

const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;
module.exports = {
    plugins: [
        new BundleAnalyzerPlugin()
    ]
 }
  • 如果项目中没有webpack.config.js文件,可以使用以下命令(注意:该操作是不可逆的):

npm run eject

  • 如果在执行eject命令时报错,可尝试以下解决方案:

git add . git commit -m 'xxx' npm run eject

3 运行

3.1 开发环境下运行

直接启动项目:

npm run start 则会自动启动项目页面和分析页面(127.0.0.1:8888 默认地址和端口号)

3.2 打包后运行

首先配置package.json

"scripts": {
    "analyz": "cross-env NODE_ENV=production npm_config_report=true npm run build"
}

运行命令:

npm run analyz

项目打包完毕后会自动启动分析页面(127.0.0.1:8888 默认地址和端口号)

4 BundleAnalyzerPlugin配置项和默认参数

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