React / 系统课时
分析构建产物
分析构建产物
构建成功并不代表首屏足够轻。真正需要确认的是:哪些依赖进入浏览器包、哪些模块被客户端边界带入首屏,以及优化后体积是否真的下降。本节用 Next.js Bundle Analyzer 建立可重复的分析流程。
学习目标
- 为 Next.js 构建启用 Bundle Analyzer 并生成可视化报告
- 区分客户端、服务端依赖,定位真正影响首屏 JavaScript 的模块
- 依据模块体积和加载时机选择拆包、延迟加载或依赖替换策略
启用构建分析
先安装官方 Bundle Analyzer 包和 cross-env,后者用于在不同操作系统中统一设置 ANALYZE 环境变量。
npm install -D @next/bundle-analyzer cross-env预期结果是命令以状态码 0 结束,安装数量会随项目锁文件变化,例如:
added <VALUE> packages然后在 next.config.mjs 中包裹现有 Next.js 配置。若项目已有其他配置项,把它们保留在 nextConfig 中即可。
import withBundleAnalyzer from '@next/bundle-analyzer';
const nextConfig = {};
export default withBundleAnalyzer({
enabled: process.env.ANALYZE === 'true',
})(nextConfig);配置生效后,普通 next build 不会开启分析;只有显式设置 ANALYZE=true 时才生成报告,因此不会影响日常构建流程。
生成并读取报告
执行一次生产构建分析:
npx cross-env ANALYZE=true next build预期结果是构建成功并生成可交互的 bundle 报告,终端关键结果类似:
✓ Compiled successfully in <TIME><TIME> 会随机器和项目规模变化。Bundle Analyzer 会把模块按体积绘制为矩形,矩形越大,代表其在对应 bundle 中占用越多。
阅读报告时先看客户端 bundle,因为只有进入浏览器的 JavaScript 才会直接增加下载、解析和执行成本。服务端依赖即使很大,也不能仅凭体积就判定会拖慢首屏。
找到真正的首屏负担
定位大模块时先回答两个问题:它为什么进入客户端包,以及它是否必须在首屏执行。App Router 中,"use client" 会建立客户端边界;被该客户端组件静态依赖的浏览器代码可能一起进入客户端构建,所以一个过大的客户端边界经常比单个依赖本身更值得检查。
例如图表、富文本编辑器、地图等模块如果只在用户进入某个交互区域后才需要,可以把它们放进独立 Client Component,再用动态加载延后下载。不要为了减少数字而把所有模块都改成动态加载;首屏立即需要的组件拆得过碎,反而可能增加请求和等待。
对于大依赖,还要检查是否存在更小的导入路径、是否把整套工具库一次性引入、是否可以在 Server Component 中完成计算后只把结果传给客户端。优化目标不是“让 server bundle 最小”,而是减少用户首屏真正需要下载和执行的代码。
用前后对比验证优化
每次只改一个主要因素,然后重新执行分析命令,比较同一客户端报告中的目标模块。若大模块消失、缩小或移动到非首屏按需加载的 chunk,说明优化方向有效;如果只是从一个 chunk 挪到另一个首屏 chunk,总下载量并没有真正下降。
同时用浏览器性能指标或 Lighthouse 验证真实页面效果。Bundle Analyzer 负责回答“代码为什么这么大”,而页面指标负责回答“用户是否因此更快”。只有构建体积和运行体验都改善,才算完成一次可靠的性能优化闭环。