在 vite 中配置代码分割,核心是修改 build.rollupoptions 中的 output.manualchunks 函数。该函数接收模块 id 和拆分信息,通过返回字符串名称将指定模块归入独立 chunk,不传值则保持默认打包策略。正确设置后,vite 会将大型第三方库或业务逻辑拆分为单独文件,提升浏览器并行加载效率。

如何按模块类型拆分 vendor 和业务代码
要实现基础的业务与依赖分离,需在 manualChunks 中判断模块路径。当模块来自 node_modules 时,将其统一放入名为 vendor 的 chunk;否则保留在入口 chunk 中。这种配置能确保所有第三方库被合并为一个文件,而业务代码随入口文件分发。

export default {
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (id.includes('node_modules')) {
return 'vendor';
}
}
}
}
}
}
运行构建后,生成的 HTML 会引入 vendor-[hash].js 和 index-[hash].js。其中 vendor 包含所有 node_modules 下的依赖,index 包含应用源码。若需更细粒度控制,可进一步区分框架与工具库。
立即学习“Java免费学习笔记(深入)”;
如何将 React 和 Vue 等框架独立拆分
若希望将不同框架或大型库独立成块,可在 manualChunks 中使用 Map 记录引用次数。当模块首次被引用时分配唯一 ID,多次引用时复用该 ID。例如将 react 和 vue 分别映射为 framework-react 和 framework-vue,其他依赖仍归入 vendor。这种方式能避免框架代码重复打包,并实现更精细的缓存策略。

export default {
build: {
rollupOptions: {
output: {
manualChunks(id, { getModuleInfo }) {
if (id.includes('node_modules')) {
const chunks = new Map();
const moduleInfo = getModuleInfo(id);
if (!moduleInfo) return;
// 简单示例:根据模块名分配
if (id.includes('react')) return 'framework-react';
if (id.includes('vue')) return 'framework-vue';
return 'vendor';
}
}
}
}
}
}
构建输出将包含 framework-react-[hash].js、framework-vue-[hash].js 和 vendor-[hash].js。每个 chunk 仅包含对应框架的代码,减少单文件体积。注意 getModuleInfo 用于获取模块元数据,确保拆分逻辑基于实际依赖关系。
manualChunks 函数中 id 参数代表什么
manualChunks 函数的 id 参数是当前正在处理的模块绝对路径。它包含项目根目录、文件路径及文件名,例如 /path/to/project/node_modules/react/index.js。通过解析该路径,可精准识别模块来源并执行拆分逻辑。若路径不包含 node_modules,通常视为业务代码,无需额外拆分。


















