前端工程化 / 系统课时

设计代码分割策略

设计代码分割策略

本课解决构建产物“入口过大”或“切得过碎”的问题。你将先用动态导入隔离低频功能,再用 Vite 8 的 Rolldown 分块规则管理共享依赖,最终通过构建产物验证首屏加载与缓存复用是否改善。

学习目标

  • 区分入口代码、按需功能块和共享依赖块
  • 使用动态导入创建真正的异步边界
  • 配置 codeSplitting,避免单一巨型 vendor 包和过度碎片化

先划分加载职责

代码分割应围绕用户何时需要代码,而不是围绕目录名称机械拆分。首屏必需逻辑留在入口块;报表、编辑器、管理后台等低频功能通过动态导入延后;更新频率较低且被多处使用的依赖,再考虑稳定的共享块。

Vite 代码分割后的加载与缓存关系

动态导入本身会建立异步边界;手工分块只是在自动分割结果上补充缓存和体积策略。不要先写复杂规则,再寻找可以被延迟加载的业务场景。

用动态导入移出低频功能

在现有 Vite TypeScript 项目中,将报表逻辑放到独立模块。入口只创建按钮,用户点击后才下载并执行报表代码。

ts
// src/features/report.ts
export function createReport(): string {
  return '报表模块已加载'
}
ts
// src/main.ts
const app = document.querySelector<HTMLDivElement>('#app')

if (!app) {
  throw new Error('缺少 #app 根节点')
}

const button = document.createElement('button')
const result = document.createElement('p')
button.textContent = '打开报表'
app.append(button, result)

button.addEventListener('click', async () => {
  // 只有发生交互时才加载报表模块。
  const { createReport } = await import('./features/report')
  result.textContent = createReport()
})

预期结果:

text
首次打开页面:页面显示“打开报表”,未请求 report-<ID>.js
点击按钮后:请求 report-<ID>.js,页面显示“报表模块已加载”

文件哈希会随内容变化。路由框架中的懒加载组件与这个原理相同:只有动态 import() 才会形成可独立请求的异步块。

配置共享依赖分块

Vite 8 使用 Rolldown 进行生产构建,应优先配置 build.rolldownOptions.output.codeSplitting;旧的 build.rollupOptions 只是已弃用别名。下面的通用策略把较大的第三方依赖归入 vendor 组,并把至少被两个块共享、且达到一定体积的模块归入 shared 组。

ts
import { defineConfig } from 'vite'

export default defineConfig({
  build: {
    rolldownOptions: {
      output: {
        codeSplitting: {
          groups: [
            {
              name: 'vendor',
              test: /node_modules/,
              minSize: 50_000,
              maxSize: 250_000,
              priority: 10,
            },
            {
              name: 'shared',
              minShareCount: 2,
              minSize: 20_000,
              priority: 5,
            },
          ],
        },
      },
    },
  },
})

这里的大小单位是字节,priority 较高的组优先匹配。maxSize 是优化目标而不是绝对上限;单个模块本身过大,或继续拆分会产生过小块时,最终文件仍可能超过该值。

构建并检查分块

执行生产构建:

bash
npm run build

预期输出:

text
vite v<VERSION> building for production...
✓ <ID> modules transformed.
dist/assets/index-<ID>.js
dist/assets/report-<ID>.js
✓ built in <TIME>

存在符合规则的第三方依赖或共享模块时,还会看到 vendor-<ID>.js、shared-<ID>.js 等文件。验证时不要只看文件数量,还要在浏览器网络面板确认:首屏没有请求报表块,点击后才加载;修改业务代码重新构建时,未变化的依赖块尽量保持可复用缓存。

避免两种极端

把所有 node_modules 强制塞进一个 vendor 块,可能形成下载和解析都很慢的巨型文件;按每个包或组件拆块,又会增加请求、预加载和运行时管理成本。优先保留自动分割,只对大型稳定依赖、明确的低频功能和高复用共享模块加规则。

手工分块还可能改变带副作用模块的执行时机。出现初始化顺序错误或循环依赖时,应先把强耦合模块保持在同一组,而不是继续细拆;确需保持源码执行顺序时可评估 strictExecutionOrder,但它会增加包装与产物体积。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计代码分割策略

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

登录哪都通