前端工程化 / 系统课时
设计代码分割策略
设计代码分割策略
本课解决构建产物“入口过大”或“切得过碎”的问题。你将先用动态导入隔离低频功能,再用 Vite 8 的 Rolldown 分块规则管理共享依赖,最终通过构建产物验证首屏加载与缓存复用是否改善。
学习目标
- 区分入口代码、按需功能块和共享依赖块
- 使用动态导入创建真正的异步边界
- 配置
codeSplitting,避免单一巨型 vendor 包和过度碎片化
先划分加载职责
代码分割应围绕用户何时需要代码,而不是围绕目录名称机械拆分。首屏必需逻辑留在入口块;报表、编辑器、管理后台等低频功能通过动态导入延后;更新频率较低且被多处使用的依赖,再考虑稳定的共享块。

动态导入本身会建立异步边界;手工分块只是在自动分割结果上补充缓存和体积策略。不要先写复杂规则,再寻找可以被延迟加载的业务场景。
用动态导入移出低频功能
在现有 Vite TypeScript 项目中,将报表逻辑放到独立模块。入口只创建按钮,用户点击后才下载并执行报表代码。
// src/features/report.ts
export function createReport(): string {
return '报表模块已加载'
}// 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()
})预期结果:
首次打开页面:页面显示“打开报表”,未请求 report-<ID>.js
点击按钮后:请求 report-<ID>.js,页面显示“报表模块已加载”文件哈希会随内容变化。路由框架中的懒加载组件与这个原理相同:只有动态 import() 才会形成可独立请求的异步块。
配置共享依赖分块
Vite 8 使用 Rolldown 进行生产构建,应优先配置 build.rolldownOptions.output.codeSplitting;旧的 build.rollupOptions 只是已弃用别名。下面的通用策略把较大的第三方依赖归入 vendor 组,并把至少被两个块共享、且达到一定体积的模块归入 shared 组。
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 是优化目标而不是绝对上限;单个模块本身过大,或继续拆分会产生过小块时,最终文件仍可能超过该值。
构建并检查分块
执行生产构建:
npm run build预期输出:
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,但它会增加包装与产物体积。