配置 vite 的 manualchunks 需要利用 rollup 插件机制,在构建时通过函数拦截模块 id 并返回自定义 chunk 名称。具体做法是在 vite.config.js 中设置 build.rollupoptions.output.manualchunks 为一个函数,该函数接收 id(当前模块路径)和 getmoduleinfo 方法,根据路径特征(如包含 node_modules)将依赖分离到独立文件中,从而优化浏览器缓存策略。

如何按 node_modules 提取公共库?
要实现将第三方库单独打包,只需判断 id 是否位于 node_modules 目录内。若满足条件,可提取包名作为 chunk 名称;否则返回 undefined 让 Vite 自动处理。此方法能确保 lodash、react 等核心库拥有独立的文件名哈希,更新业务代码时不会导致这些大文件失效。

export default {
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (id.includes('node_modules')) {
return id.toString().split('node_modules/')[1].split('/')[0];
}
}
}
}
}
}
如何区分 vendor 和业务代码?
若需更精细的控制,可将所有 node_modules 合并为单一的 vendor chunk,而将业务代码保留在默认 chunk 中。这通常用于项目初期或依赖变动极少的场景,以减少 HTTP 请求数量。实现方式是当检测到 node_modules 路径时直接返回字符串 'vendor',其他模块不干预。
立即学习“Java免费学习笔记(深入)”;

export default {
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (id.includes('node_modules')) {
return 'vendor';
}
}
}
}
}
}
手动分块对入口文件有什么影响?
使用 manualChunks 后,入口文件不再包含第三方库的代码,体积显著减小。这意味着浏览器解析和执行入口脚本的速度加快,同时由于第三方库被拆分,用户首次访问时只需下载必要的业务代码,后续更新也仅涉及变更部分,提升了缓存命中率。


















