开发态 HMR 配置
weapp.hmr 用来控制开发态更新时的“稳定性 vs 速度”取舍。本页只覆盖两项:
weapp.hmr.sharedChunksweapp.hmr.touchAppWxss
weapp.hmr.sharedChunks
- 类型:
'full' | 'auto' | 'off' - 默认值:
'auto' - 适用场景:开发态 HMR 时控制共享 chunk 的重建策略。
ts
import { defineConfig } from 'weapp-vite/config'
export default defineConfig({
weapp: {
hmr: {
sharedChunks: 'auto',
},
},
})取舍说明:
full:每次更新都重新产出全部 entry,最稳但最慢。auto:只在共享 chunk 可能被覆盖时回退到full,是默认折中方案。off:仅更新变更 entry,最快,但共享 chunk 导出关系复杂时更容易出现开发态不一致。
建议:
- 普通项目保持默认
auto。 - 遇到“开发态偶发错乱、刷新后恢复正常”的共享 chunk 问题时,优先尝试
full。 - 只有在你确认项目结构简单且极度在意 dev 重建速度时,再考虑
off。
weapp.hmr.touchAppWxss
- 类型:
boolean | 'auto' - 默认值:
'auto' - 适用场景:开发态构建结束后,额外触碰
app.wxss,触发微信开发者工具的热重载。
ts
import { defineConfig } from 'weapp-vite/config'
export default defineConfig({
weapp: {
hmr: {
touchAppWxss: 'auto',
},
},
})行为说明:
true:总是启用。false:关闭。auto:检测到安装weapp-tailwindcss时启用。
适用建议:
- 如果你在开发者工具里经常遇到样式更新不稳定、必须手动刷新,优先检查这一项。
- 若项目未使用
weapp-tailwindcss且样式热更新已经稳定,可保持默认或显式关闭。