在 vite 项目中使用 rollup-plugin-visualizer 需要在 vite.config.js 中引入插件并配置 open 和 gzipsize 参数,执行构建命令后会在本地生成一个可视化的 html 报告。该工具通过展示模块的体积占比和依赖关系,帮助开发者快速定位导致包体积过大的原因。

如何配置插件以生成可视化报告
配置的核心在于将插件注册到 Vite 的 build.rollupOptions.plugins 数组中,并确保开启 open: true 以便构建完成后自动打开浏览器查看结果。
import { defineConfig } from 'vite';
import visualizer from 'rollup-plugin-visualizer';
export default defineConfig({
build: {
rollupOptions: {
plugins: [
visualizer({
open: true,
gzipSize: true,
brotliSize: true,
}),
],
},
},
});
运行 npx vite build 后,控制台会输出报告生成的路径,并在默认浏览器中打开该页面。报告中会显示一个桑基图(Sankey Diagram),直观地展示从入口文件到最终打包文件的体积流转过程。
如何解读报告中的模块体积数据
报告页面提供了多种视图模式,包括桑基图、树状图和表格。在桑基图中,左侧节点代表入口或中间模块,右侧节点代表最终输出的 chunk 或外部库。线条的宽度对应模块的体积大小,颜色通常区分了不同来源的模块。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
// 假设 main.js 引入了 lodash
import _ from 'lodash';
console.log(_.merge({}, { a: 1 }));
如果 lodash 被完整引入,它在桑基图中会占据极大的比例。通过点击具体的模块节点,可以展开查看其内部包含的子模块及其体积贡献。这有助于识别是否误引入了整个大型库而非按需导入。例如,若发现 lodash 占比较大,应改为使用 lodash-es 并结合 Tree Shaking 进行按需引用。
基于特定输入条件分析未压缩与压缩后的体积差异
当配置了 gzipSize: true 时,报告会同时显示原始体积和 Gzip 压缩后的体积。这对于评估实际网络传输成本至关重要,因为某些代码虽然原始体积大,但压缩率高,对带宽影响较小;反之亦然。
const heavyLib = require('some-heavy-library');
// 模拟大量重复代码
for (let i = 0; i <p>在上述示例中,如果 <code>some-heavy-library</code> 包含大量可压缩的代码结构,其 Gzip 体积可能显著小于原始体积。通过对比这两个数值,可以判断是否需要针对特定模块进行优化,或者是否可以接受当前的体积表现。若 Gzip 体积依然过大,则需考虑代码分割或替换更轻量的替代方案。</p>
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










