React / 系统课时
代码分割与懒加载
代码分割与懒加载
当应用功能越来越多时,首屏不必下载所有页面和重型组件的代码。本篇用 lazy、动态 import() 与 Suspense 建立按需加载边界,让非首屏功能在真正渲染时再下载,并说明如何判断拆分粒度是否合理。
学习目标
- 能按页面或独立功能选择代码分割边界
- 能使用
lazy与Suspense完成可运行的懒加载 - 能识别过度拆分、错误声明位置和加载失败等常见边界
先确定拆分边界
静态 import 会让模块进入当前构建依赖图;lazy(() => import(...)) 则把组件代码推迟到第一次尝试渲染时再加载。最常见的拆分点是路由页面、后台管理区、富文本编辑器、图表等“首屏不一定需要且体积明显”的功能。
不要把每个小按钮都拆成独立 chunk。拆分越细,请求与调度开销越多,也更容易形成“先加载页面代码,再发现还要加载子功能”的瀑布。优先从页面级或大功能级边界开始,再用真实加载数据决定是否继续细分。

用 lazy 按需加载功能组件
下面是片段示例,假设项目已经有可运行的 React 入口,只替换 App.jsx 并新增 SettingsPage.jsx。懒加载组件必须在模块顶层声明,目标模块使用默认导出。
// App.jsx
import { lazy, Suspense, useState } from 'react';
const SettingsPage = lazy(() => import('./SettingsPage.jsx'));
export default function App() {
const [page, setPage] = useState('home');
return (
<main>
<nav>
<button onClick={() => setPage('home')}>首页</button>
<button onClick={() => setPage('settings')}>设置</button>
</nav>
{page === 'home' ? (
<h1>首页</h1>
) : (
<Suspense fallback={<p>正在加载设置功能…</p>}>
<SettingsPage />
</Suspense>
)}
</main>
);
}// SettingsPage.jsx
console.log('SettingsPage 模块已加载');
export default function SettingsPage() {
return <h1>设置</h1>;
}预期结果:首次打开应用只显示“首页”,控制台不会出现设置模块日志。第一次点击“设置”后,模块加载并输出一次日志;代码尚未就绪时由 Suspense 显示加载占位,完成后显示“设置”。再次在首页与设置间切换时,lazy 会复用已经解析的模块。
SettingsPage 模块已加载处理真实项目中的边界
lazy 的加载函数应返回最终包含 default 组件的 Promise,因此最省事的做法是让被拆分页面使用默认导出。如果现有模块只有命名导出,可以增加一个很薄的适配模块,再从适配模块默认导出目标组件。
Suspense 负责“代码还没准备好时显示什么”,并不负责处理模块加载失败。动态导入如果因为网络错误或部署资源缺失而失败,应由最近的错误边界接住异常,并给用户重试或刷新入口。
判断优化是否值得
代码分割的目标不是让 chunk 数量越多越好,而是减少关键路径上不必要的 JavaScript。首屏必用、体积很小、很快就会访问的组件通常保持静态导入;访问概率低或依赖明显较重的页面更适合懒加载。
当拆分边界与用户导航边界一致时,代码结构、缓存行为和加载体验通常最容易维护。先做页面级拆分,再观察实际加载顺序与体积,通常比一开始追求极细粒度更稳妥。