代码分割解决单页应用首屏加载体积过大问题,通过按需加载路由、组件、功能模块等,避免用户下载未使用代码。

代码分割能显著减少首屏加载体积,让应用启动更快、运行更流畅。它把大块js拆成小块,按需加载,避免用户下载根本用不到的代码。
代码分割解决什么问题
单页应用打包后常生成一个几MB的bundle.js,用户首次访问得等全部下载解析完才能交互。实际可能只用到其中20%的功能,其余都白下了。代码分割就是把不同路由、组件或功能模块单独打包,在需要时才拉取对应代码。
常见适用场景包括:
- 路由级拆分:用户访问 /admin 时才加载管理后台模块
- 组件级懒加载:模态框、图表、富文本编辑器等非首屏组件延迟加载
- 条件性功能:用户点击“导出pdf”才加载 pdf-lib 库
- 实验性功能:灰度发布时只给部分用户加载新模块
动态 import() 的基本用法
动态 import() 是 ES2020 标准语法,返回 promise,可在任意位置调用,不局限于模块顶层。
立即学习“Java免费学习笔记(深入)”;
最简单的写法:
“`js
button.addEventListener(‘click’, async () => {
const module = await import(‘./chart.js’);
module.renderChart();
});
“`
它会自动把 ./chart.js 拆成独立 chunk,webpack 或 vite 编译时识别并处理。注意路径必须是静态字符串(不能是变量拼接),否则构建工具无法预分析。
配合 react 实现组件懒加载
React 官方推荐用 React.lazy + Suspense 包装动态 import:
“`jsx
const HeavyComponent = React.lazy(() => import(‘./HeavyComponent’));
function app() {
return (
Webpack 和 Vite 的差异提示
两者都原生支持动态 import(),但细节有别:
- Webpack 默认给每个 import() 生成带 hash 的独立文件,可通过 webpackChunkName 注释统一命名:
import(/* webpackChunkName: “charts” */ ‘./chart.js’) - Vite 更轻量,默认按路径生成 chunk 名,也支持注释写法,但更推荐用 build.rollupOptions.output.manualChunks 做精细分组
- 服务端渲染(SSR)项目中,动态 import 在服务端执行会报错,需加判断:
if (typeof window !== ‘undefined’) await import(‘./client-only.js’)
基本上就这些。动态 import() 不复杂但容易忽略——它不是锦上添花的优化技巧,而是现代前端工程的基础设施之一。