Wevu 编译期配置
本页聚焦 weapp.wevu 这组“编译期注入 / 默认值治理”配置。它们主要影响：
app.vue编译时是否自动注入setWevuDefaults()- 组件 / 页面默认
setData策略 - 是否自动从模板推导
setData.pick
NOTE
这里讨论的是 weapp-vite 在编译阶段帮你做什么，不是 wevu 运行时 API 的完整手册。运行时能力请继续阅读 /wevu/runtime。
weapp.wevu.defaults
- 类型：
WevuDefaults - 默认值：
undefined - 作用：在编译
app.vue时自动注入setWevuDefaults()，统一控制 Wevu 的createApp/defineComponent默认值。
配置示例
ts
import { defineConfig } from 'weapp-vite/config'
export default defineConfig({
weapp: {
wevu: {
defaults: {
app: {
setData: {
includeComputed: false,
strategy: 'patch',
},
},
component: {
options: {
addGlobalClass: true,
},
setData: {
strategy: 'patch',
},
},
},
},
},
})注意事项
- 仅对
app.vue生效：Weapp-vite 会在编译产物中插入setWevuDefaults()，并确保它在createApp()之前执行。 - 配置必须可序列化（JSON 兼容）：不支持函数、
Symbol、循环引用。 - 局部显式配置会覆盖默认值；
setData与options会做浅合并，其余字段按对象顶层合并。 - 若你希望手动控制时机，可以在
app.vue顶层显式调用setWevuDefaults()，并关闭此配置以避免重复注入。 - 当
app.vue/组件导出为对象字面量时，Weapp-vite 会把默认值直接合并进编译产物，方便排查与调试；若导出是变量或函数，仍会回落到运行时合并。 - 若设置了
component.options.virtualHost = true，Weapp-vite 会在 页面 入口自动补上virtualHost: false，避免页面虚拟节点导致的渲染层错误；需要为页面开启时请在页面内显式配置。
TIP
如果你不通过 Weapp-vite 构建，也可以在运行时手动调用 setWevuDefaults()（见 /wevu/runtime）。
weapp.wevu.preset
- 类型：
'performance' - 默认值：
undefined - 作用：一键启用性能向默认项，降低
setData快照与后台态更新带来的开销。
配置示例
ts
import { defineConfig } from 'weapp-vite/config'
export default defineConfig({
weapp: {
wevu: {
preset: 'performance',
},
},
})performance 预设内容
- 为
app/component注入setData.strategy: 'patch'。 - 为
app/component注入setData.suspendWhenHidden: true。 - 为
app/component注入开发态高频告警：setData.highFrequencyWarning = { enabled: true, devOnly: true }。 - 默认启用
autoSetDataPick；若你显式设置autoSetDataPick: false，则以显式配置为准。
覆盖规则
- 预设先应用，再与
weapp.wevu.defaults做浅合并，setData/options仍按字段浅合并。 - 你在
weapp.wevu.defaults中写的同名字段，优先级高于预设默认值。
weapp.wevu.autoSetDataPick
- 类型：
boolean - 默认值：
false - 作用：在编译阶段从模板表达式自动提取渲染相关顶层 key，并注入到组件/页面的
setData.pick，减少非渲染字段参与快照与下发。
IMPORTANT
该能力默认关闭，不会在未配置时自动开启。只有显式设置 weapp.wevu.autoSetDataPick: true 才会生效。 从旧版本升级到新版本时，若你未手动开启该项，行为保持不变。 如果启用了 weapp.wevu.preset: 'performance'，则会默认开启该项，仍可通过显式 false 覆盖。
配置示例
ts
import { defineConfig } from 'weapp-vite/config'
export default defineConfig({
weapp: {
wevu: {
autoSetDataPick: true,
},
},
})行为说明
- 仅对
defineComponent/createWevuComponent产物生效，app.vue不会注入。 - 若组件已显式声明
setData.pick数组，会与自动推导结果做去重合并。 - 若
setData为变量或表达式，例如setData: externalConfig，会包裹为{ pick: [...], ...externalConfig }以保持兼容。 - 建议在“状态很大但模板只使用少量字段”的页面优先开启；若模板几乎使用全部字段，收益通常不明显。
FAQ
Q: autoSetDataPick 默认会自动开启吗？
不会。默认值是 false，只有显式配置 weapp.wevu.autoSetDataPick: true 才会生效。
Q: 为什么我在 app.vue 里看不到注入结果？
这是预期行为。该能力仅对 defineComponent/createWevuComponent 产物生效，不会对 app.vue 注入 setData.pick。
Q: 我已经手写了 setData.pick，会被覆盖吗？
不会。自动推导结果会与已有 setData.pick 做去重合并，不会丢掉你手写的 key。
Q: 怎么快速确认它是否生效？
先执行一次构建，然后检查页面/组件产物 JS 中是否出现 setData.pick。若模板含调用表达式，通常也会看到 __wv_bind_* 被写入 pick 数组。