Skip to main content

代码分割 Code Splitting

随着应用的增长,代码 bundle 的大小也将随之增长。为了避免因体积过大而导致加载时间过长,我们可以按照路由对代码进行分割成不同的代码块,然后当路由被访问的时候才加载对应的代码,能够显著地提高应用性能。

基于路由代码分割#

推荐以路由维度分割代码,每个路由对应的代码会生成一个独立的 js 和 css。

配置式路由#

在配置式路由中如果需要开启按需加载,只需要在路由文件中通过 lazy 方法引入组件即可:

// src/routes.ts
+ import { lazy } from 'ice';
- import UserLogin from '@/pages/UserLogin';
+ const UserLogin = lazy(() => import('@/pages/UserLogin'));
const routerConfig = [
{
path: '/login',
component: UserLogin,
},
]

默认生成的 chunk 是按照 [index] 作为 chunk 名称,但我们可以通过 webpackChunkName 指定每个 chunk 来自哪个文件,以便于查看和调试:

const UserLogin = lazy(() => import('@/pages/UserLogin'));
+ const UserLogin = lazy(() => import(/* webpackChunkName: 'user-login' */'@/pages/UserLogin'));

约定式路由#

在约定式路由中如果需要开启按需加载,只需要在 build.json 中的 router 选项配置 lazy 属性即可:

// build.json
{
"router": {
+ "lazy": true
}
}

fallback#

当组件动态加载过程中或者组件渲染失败时,可以通过 fallback 属性设置提示:

import { runApp } from 'ice';
const appConfig = {
router: {
+ fallback: <div>loading...</div>
}
}
runApp(appConfig);

非路由代码分割#

除了路由维度,我们也可以做一些更小粒度比如组件级别的代码分割:

import { lazy } from 'ice';
import React, { Suspense } from 'react';
const OtherComponent = lazy(() => import('@/components/RichEditor'));
function MyComponent() {
return (
<div>
<Suspense fallback={<div>Loading...</div>}>
<OtherComponent />
</Suspense>
</div>
);
}

对应用进行代码分割可以避免加载用户永远不需要的代码,并在初始加载的时候减少所需加载的代码量,在大多数时候我们推荐使用代码分割来提升应用的加载速度和性能。