uni-app + Monorepo + 微信小程序热更新失效问题排查与结论总结

记录一次 uni-app + Vite + Monorepo 场景下，微信小程序热更新行为不一致的问题排查过程。结论不是“配置问题”，而是 启动方式 + 微信开发者工具生命周期 + 项目结构共同作用的结果。

一、问题背景

我这边实际同时维护了 三种 uni-app 项目形态：

传统 uni-app（HBuilderX 黑盒项目）
Vite + Vue3 + TS 的 uni-app 项目
Monorepo 中的 uni-app 子项目（复用 packages）

在开发 微信小程序 时，我遇到了一个非常诡异的问题：

第一次启动项目可以热更新
项目中断 → 再次启动
微信开发者工具 不报错
dist/dev/mp-weixin 文件确实发生变化
❌ 但页面完全不热更新

而这个问题在不同项目形态下，表现并不一致。

二、三种 uni-app 项目形态 & 目录结构对照

项目 1：传统 uni-app（HBuilderX 黑盒项目）

创建方式

HBuilderX：新建 → uni-app 项目

目录结构

project-uni-classic/
├── pages/
│   └── index/
│       └── index.vue
├── static/
├── uni.scss
├── App.vue
├── main.js
├── manifest.json
├── pages.json
└── uni_modules/

特征

❌ 无 package.json
❌ 无 vite.config
✅ 只能通过 HBuilderX 面板运行
✅ 微信小程序热更新 最稳定

项目 2：Vite + Vue3 + TS 的 uni-app 项目

创建方式

npx degit dcloudio/uni-preset-vue#vite-ts

目录结构

project-uni-vite/
├── src/
│   ├── pages/
│   │   └── index/
│   │       └── index.vue
│   ├── App.vue
│   ├── main.ts
│   ├── manifest.json
│   └── pages.json
├── index.html
├── package.json
├── shims-uni.d.ts
├── tsconfig.json
└── vite.config.ts

特征

✅ Vite + Vue3 + TS
✅ 可通过 HBuilderX 或命令行启动
⚠️ 热更新是否稳定，取决于 启动方式

项目 3：Monorepo 中的 uni-app 子项目

整体结构

monorepo-root/
├── packages/
│   └── core/
│       ├── src/
│       └── package.json
├── apps/
│   ├── web/
│   └── uni/
│       ├── src/
│       ├── index.html
│       ├── package.json
│       ├── shims-uni.d.ts
│       ├── vite.config.ts
│       └── tsconfig.json
├── pnpm-workspace.yaml
└── package.json