React / 系统课时
代码分割与懒加载
代码分割与懒加载
本课解决前端首屏一次加载全部业务代码的问题。你将使用动态导入、React.lazy 与 Suspense 把页面拆成独立代码块,并验证代码只在用户访问对应路由时下载。
学习目标
- 理解动态导入如何形成独立构建产物
- 使用
React.lazy和Suspense实现路由级懒加载 - 识别加载占位、导出方式与拆分粒度的关键边界
为什么要拆分代码
普通静态导入会把模块纳入当前入口的依赖图。页面越多,首次下载、解析和执行的 JavaScript 越大,用户即使只访问首页,也可能提前加载后台报表、编辑器等低频功能。
动态导入 import() 返回 Promise,构建工具会把目标模块拆成独立代码块。浏览器执行到该语句时才请求对应文件,从而把“首次必需代码”和“后续按需代码”分开。

路由级懒加载实现
下面示例基于 Vite 创建的 React 18 TypeScript 项目。先安装路由依赖。
npm install react-router-dom预期输出
added <COUNT> packages<COUNT> 会随锁文件和 npm 版本变化。接着创建两个页面,并在路由入口中使用动态导入。
// src/pages/HomePage.tsx
export default function HomePage() {
return <h2>首页</h2>;
}
// src/pages/ReportPage.tsx
export default function ReportPage() {
return <h2>报表中心</h2>;
}
// src/App.tsx
import { lazy, Suspense } from "react";
import { BrowserRouter, Link, Route, Routes } from "react-router-dom";
const HomePage = lazy(() => import("./pages/HomePage"));
const ReportPage = lazy(() => import("./pages/ReportPage"));
export default function App() {
return (
<BrowserRouter>
<nav>
<Link to="/">首页</Link>{" "}
<Link to="/reports">报表</Link>
</nav>
<Suspense fallback={<p>页面加载中...</p>}>
<Routes>
<Route path="/" element={<HomePage />} />
<Route path="/reports" element={<ReportPage />} />
</Routes>
</Suspense>
</BrowserRouter>
);
}预期结果
项目启动后,首页显示“首页”;点击“报表”时先显示“页面加载中...”,随后显示“报表中心”。运行开发服务器。
npm run dev预期输出
VITE ready in <TIME> ms
Local: http://localhost:<PORT>/打开开发者工具的 Network 面板,首次访问首页时不会下载报表页面对应的模块;点击“报表”后,才会出现新的 JavaScript 请求。<TIME> 和 <PORT> 的实际值可能不同。
Suspense 的职责
React.lazy 接收一个返回动态导入 Promise 的函数,并把默认导出转换为可渲染组件。模块尚未加载完成时,组件会暂停渲染,最近一层 Suspense 显示 fallback。
fallback 应保持轻量,并尽量维持页面布局稳定。路由级拆分通常在主内容区域放置加载骨架,而不是让整页闪烁或清空导航。
React.lazy默认读取模块的default导出。若目标模块只有命名导出,需要增加一层转换,或直接调整为默认导出。
拆分粒度与验证
优先按路由拆分,因为页面天然对应用户访问边界。大型编辑器、图表库、地图或仅在弹窗中使用的功能,也适合按功能动态导入。
不要把每个小组件都拆成独立代码块。代码块过细会增加网络请求、调度和缓存管理成本。首屏立即需要的组件也不应懒加载,否则只会延迟可见内容。生产构建后可检查拆分结果。
npm run build预期输出
dist/assets/index-<HASH>.js
dist/assets/HomePage-<HASH>.js
dist/assets/ReportPage-<HASH>.js文件名和哈希值可能不同,但应能看到入口文件与页面代码块被分别输出。