React / 系统课时

代码分割与懒加载

代码分割与懒加载

本课解决前端首屏一次加载全部业务代码的问题。你将使用动态导入、React.lazy 与 Suspense 把页面拆成独立代码块,并验证代码只在用户访问对应路由时下载。

学习目标

  • 理解动态导入如何形成独立构建产物
  • 使用 React.lazy 和 Suspense 实现路由级懒加载
  • 识别加载占位、导出方式与拆分粒度的关键边界

为什么要拆分代码

普通静态导入会把模块纳入当前入口的依赖图。页面越多,首次下载、解析和执行的 JavaScript 越大,用户即使只访问首页,也可能提前加载后台报表、编辑器等低频功能。

动态导入 import() 返回 Promise,构建工具会把目标模块拆成独立代码块。浏览器执行到该语句时才请求对应文件,从而把“首次必需代码”和“后续按需代码”分开。

静态导入与动态导入的加载差异

路由级懒加载实现

下面示例基于 Vite 创建的 React 18 TypeScript 项目。先安装路由依赖。

bash
npm install react-router-dom

预期输出

text
added <COUNT> packages

<COUNT> 会随锁文件和 npm 版本变化。接着创建两个页面,并在路由入口中使用动态导入。

tsx
// 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>
  );
}

预期结果

text
项目启动后,首页显示“首页”;点击“报表”时先显示“页面加载中...”,随后显示“报表中心”。

运行开发服务器。

bash
npm run dev

预期输出

text
VITE ready in <TIME> ms
Local: http://localhost:<PORT>/

打开开发者工具的 Network 面板,首次访问首页时不会下载报表页面对应的模块;点击“报表”后,才会出现新的 JavaScript 请求。<TIME> 和 <PORT> 的实际值可能不同。

Suspense 的职责

React.lazy 接收一个返回动态导入 Promise 的函数,并把默认导出转换为可渲染组件。模块尚未加载完成时,组件会暂停渲染,最近一层 Suspense 显示 fallback。

fallback 应保持轻量,并尽量维持页面布局稳定。路由级拆分通常在主内容区域放置加载骨架,而不是让整页闪烁或清空导航。

React.lazy 默认读取模块的 default 导出。若目标模块只有命名导出,需要增加一层转换,或直接调整为默认导出。

拆分粒度与验证

优先按路由拆分,因为页面天然对应用户访问边界。大型编辑器、图表库、地图或仅在弹窗中使用的功能,也适合按功能动态导入。

不要把每个小组件都拆成独立代码块。代码块过细会增加网络请求、调度和缓存管理成本。首屏立即需要的组件也不应懒加载,否则只会延迟可见内容。生产构建后可检查拆分结果。

bash
npm run build

预期输出

text
dist/assets/index-<HASH>.js
dist/assets/HomePage-<HASH>.js
dist/assets/ReportPage-<HASH>.js

文件名和哈希值可能不同,但应能看到入口文件与页面代码块被分别输出。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

代码分割与懒加载

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通