根本原因在于uni-app的Vite插件层(uni:app)强制重写入口、注入平台代码并二次解析依赖,导致Vite缓存频繁失效;同时HBuilderX默认全目录监听、动态require及未清理node_modules/.vite和unpackage进一步加剧编译变慢。

为什么Vite在uni-app里编译变慢,不是Vite的问题
根本原因在于uni-app的Vite插件层(uni:app)在每次构建时,会强制重写部分入口逻辑、注入平台适配代码,并对node_modules中大量依赖做二次解析。尤其当项目含多端条件编译(如#ifdef MP-WEIXIN嵌套多层)、或引入了未声明externals的大型UI库(如uview-plus),Vite的缓存机制就会频繁失效——不是它不缓存,而是uni-app插件主动让缓存“过期”。
关闭dev server自动重启和冗余监听
开发时热更新卡顿,90%是因为HBuilderX或命令行启动的npm run dev:mp-weixin默认开启了全文件监听,包括static/、unpackage/甚至node_modules子目录。这些路径根本不参与Vite编译流程,却触发了不必要的依赖图重建。
- 在
vite.config.ts中显式配置server.watch,只监听源码目录:server: { watch: { ignored: ['**/static/**', '**/unpackage/**', '**/node_modules/**'] } } - 禁用HBuilderX的“保存自动编译”:菜单栏 → 运行 → 运行到小程序模拟器 → 取消勾选“保存时自动运行”
- 避免在
main.js或App.vue里动态require路径(比如require('./config/' + env + '.js')),这会让Vite无法静态分析依赖,每次改env都清空缓存
清理node_modules/.vite和unpackage是最快见效的操作
uni-app的Vite构建会在node_modules/.vite存预构建产物,但它的清理逻辑不如原生Vite健壮;同时unpackage/下残留的旧平台中间产物(如dist/build/mp-weixin/app-service.js)会被复用,导致缓存污染——表现为:改了pages.json但路由没更新、删了组件但H5仍报Component not found。
- 每次切换平台(如从
mp-weixin切到h5)前,手动执行:rm -rf node_modules/.vite unpackage/
- CI/CD中务必加入该清理步骤,不能只靠
npm run build内部逻辑 - 若使用HBuilderX,它不会自动清理
unpackage,必须右键项目 → “清理项目” → 勾选“清理编译缓存”
defineConfig里加build.rollupOptions.cache反而有害
有人看到Rollup文档说开启cache能提速,于是在vite.config.ts里写build.rollupOptions = { cache: true }——这是典型误区。Vite 4+已弃用该选项,且uni-app的uni:app插件本身会接管Rollup缓存策略。强行启用会导致:
- 构建产物体积异常增大(重复打包相同模块)
- 修改
vue模板后,.js文件没更新,但.css变了,造成样式错乱 - 微信开发者工具里出现
Cannot find module 'xxx' in app-service.js错误
真正有效的缓存控制,只在build.rollupOptions.output里做entryFileNames和chunkFileNames的content-hash命名,其他一律交给Vite默认行为。











