Skip to content

在 weapp-vite 中使用 Vue SFC

weapp-vite 内置了 Vue SFC 编译链路,配合 wevu 运行时即可用 Vue 风格开发小程序页面/组件,同时保持小程序能力(页面特性、分享、性能优化)。

适用版本:Vue SFC 仅在 [email protected] 及以上可用,请先升级到 6 大版本。

快速开始

  • 需要安装 wevu(任意包管理器均可 add/install wevu)。
  • 官方模板已默认带上,手动集成时请先装依赖再继续。

心智模型

Vue SFC 在小程序里建议拆成两段:

  • 编译期(weapp-vite):负责把 .vue 拆解/编译为小程序产物(WXML/WXSS/JS/JSON),并做模板语法(如 v-if/v-for/v-model)到 WXML 的转换。
  • 运行期(wevu):负责响应式、生命周期 hooks、快照 diff 与最小化 setData,让你用 Vue 3 风格的 Composition API 写业务逻辑。
mermaid
flowchart LR
  A[Vue SFC<br/>.vue] --> B[编译期<br/>weapp-vite]
  B --> C[小程序产物<br/>WXML / WXSS / JS / JSON]
  C --> D[运行期<br/>wevu]
  D --> E[小程序逻辑层<br/>响应式 / hooks / diff + setData]
  E --> F[渲染层更新<br/>UI]

章节导航

  • 基础与组成:SFC 各块作用、宏/指令的编译时与运行时、页面与组件区分等
  • 配置与宏usingComponents 规则、<json> 与 Script Setup JSON 宏
  • 模板与指令:页面事件触发机制、v-model 支持范围与限制
  • class/style 绑定:对齐 Vue 3 的 class/style 语法与运行时模式
  • 示例:页面示例与组件 v-model 示例
  • 调试与排错:常见问题定位与建议

Released under the MIT License.