在 vite 项目中配置 vendor 分包,核心做法是利用 @rollup/plugin-commonjs 或更推荐的 @vitejs/plugin-vue 配合自定义 rollup 插件来提取公共依赖,但最标准且无需额外插件的方式是直接在 vite.config.js 的 build.rollupoptions.output.manualchunks 中定义拆分规则。通过返回一个字符串作为 chunk 名称,vite 会将匹配到的模块打包进独立的文件,从而利用浏览器缓存提升加载性能。

如何根据 node_modules 中的包名自动拆分 vendor chunk?
要实现自动拆分,需要在 manualChunks 函数中检查当前模块是否位于 node_modules 目录,并提取其包名(即路径中第一个斜杠前的部分)。如果包名存在,则将其作为 chunk 名称返回;否则返回 undefined 以使用默认行为。这样,每个第三方库都会生成一个独立的 JS 文件。
export default defineConfig({
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (id.includes('node_modules')) {
return id.toString().split('node_modules/')[1].split('/')[0];
}
}
}
}
}
})
上述代码会遍历所有被打包的模块。当遇到包含 node_modules 的路径时,它截取包名部分。例如,lodash 和 react 会被分别打包为 lodash.js 和 react.js。这种策略确保了大型库的变更不会导致整个 vendor bundle 失效。
如何将业务代码与第三方库分离并进一步细分?
除了按包名拆分,通常还需要将应用自身的代码(非 node_modules)单独打包为一个 app.js,以便区分业务逻辑和依赖。同时,可以将较小的、不常变动的库合并到一个 vendor.js 中,以减少 HTTP 请求数量。这需要结合 id.includes 判断来源,并对小库进行分组。
在代码库出现结构漂移之前,扫描JS或TS代码库中的禁止导入、循环依赖、孤立模块和其他依赖规则违规情况。
export default defineConfig({
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (id.includes('node_modules')) {
// 将小库合并到 vendor
if (['axios', 'dayjs'].some(pkg => id.includes(pkg))) {
return 'vendor';
}
// 大库独立
return id.toString().split('node_modules/')[1].split('/')[0];
}
// 业务代码独立
return 'app';
}
}
}
}
})
在这个配置中,axios 和 dayjs 会被合并到同一个 vendor.js 文件中,而像 vue 或 react 这样的大型库则会保持独立。业务代码则统一进入 app.js。这种混合策略平衡了缓存命中率和请求开销。
手动拆分后如何验证生成的 chunk 文件名是否正确?
配置完成后,运行 npm run build 查看构建输出。在 dist 目录下,你会看到类似 assets/vue-xxx.js、assets/app-xxx.js 的文件。文件名后的哈希值是由内容决定的,确保每次构建都能正确映射。可以通过检查 HTML 入口文件中的 <script></script> 标签来确认这些 chunk 是否被正确引用。如果某个库没有被拆分,检查其是否在 node_modules 中以及 manualChunks 的逻辑是否覆盖了该路径。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










