在 vite 项目中生成构建报告,最直接的方法是在运行构建命令时添加 --report 参数。该参数会调用内置的 vite-bundle-visualizer 插件,自动分析打包后的资源并生成可视化的 html 报告文件。执行完成后,控制台会输出报告文件的保存路径,直接在浏览器中打开即可查看各模块的大小占比。

如何配置自定义报告文件名和路径
使用 --report 参数时,可以通过附加 --report-options 来指定输出的文件名和目录。默认情况下,报告文件名为 report.html 并保存在项目根目录。通过设置 filename 选项,可以将报告保存到特定文件夹或更改名称,方便集成到 CI/CD 流程中。

npm run build -- --report --report-options filename=dist/report.html
上述命令会在 dist 目录下生成 report.html。如果 dist 目录不存在,Vite 会自动创建它。确保路径是相对于项目根目录的绝对路径或有效的相对路径。
如何在代码中编程式生成构建报告
除了命令行参数,也可以在 Vite 配置文件中使用 @intlify/vite-plugin-vue-i18n 或其他支持 Bundle Visualizer 的插件进行编程式配置。这种方式更适合需要自动化处理报告或结合其他构建逻辑的场景。通过在 plugins 数组中添加相关插件实例,可以精确控制报告的生成时机和内容。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

// vite.config.js
import { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
import { visualizer } from 'rollup-plugin-visualizer';
export default defineConfig({
plugins: [
vue(),
visualizer({
open: true,
gzipSize: true,
brotliSize: true,
filename: 'stats.html'
})
]
});
这种配置方式会在每次构建后自动打开 stats.html 报告。与命令行方式相比,它提供了更细粒度的控制,例如启用 gzip 和 brotli 压缩大小分析。注意,rollup-plugin-visualizer 是 Vite 底层 Rollup 的插件,Vite 官方推荐的 --report 功能实际上是基于类似的原理实现的。
构建报告中各模块大小的具体含义是什么
生成的构建报告以桑基图(Sankey Diagram)的形式展示模块之间的依赖关系和体积贡献。每个节点代表一个文件或模块,边的宽度表示该模块对最终包大小的影响。主要关注的是“入口”节点到“输出”节点的流量分布,这有助于识别哪些第三方库或内部模块占据了大部分空间。例如,如果某个 UI 库的边非常宽,说明它被大量引入且未做树摇优化。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










