Skip to content

Vue SFC 配置

weapp-vite 内置对 Vue SFC 的支持(.vue → WXML/WXSS/JS/JSON),这页专门说明与 SFC 编译相关的配置项。

weapp.vue.enable

  • 类型boolean
  • 默认值true
  • 说明:保留字段。当前版本会在检测到 .vue 文件时自动启用 SFC 支持,该字段暂不影响行为。

weapp.vue.template

  • 类型
    ts
    {
      removeComments?: boolean
      simplifyWhitespace?: boolean
      scopedSlotsCompiler?: 'auto' | 'augmented' | 'off'
      slotMultipleInstance?: boolean
    }
  • 适用场景:希望调整模板编译产物(注释、空白、作用域插槽策略)。
ts
import { defineConfig } from 'weapp-vite/config'

export default defineConfig({
  weapp: {
    vue: {
      template: {
        removeComments: true,
        simplifyWhitespace: true,
        scopedSlotsCompiler: 'auto',
        slotMultipleInstance: true,
      },
    },
  },
})

字段说明:

  • removeComments: 是否移除模板注释。
  • simplifyWhitespace: 是否简化空白字符。
  • scopedSlotsCompiler: 作用域插槽编译策略:
    • auto: 自动选择最小可用方案(默认)。
    • augmented: 强制使用增强方案。
    • off: 关闭 scoped slot 编译,仅保留原生 slot(不支持 slot props)。
  • slotMultipleInstance: v-for 下 scoped slot 多实例模式(默认开启)。

weapp.vue.autoImport

  • 类型boolean
  • 默认值undefined
  • 说明:保留字段,当前不影响构建行为。

TIP

组件自动导入请使用 weapp.autoImportComponents,该功能面向 WXML/JSON 产物,而非脚本侧导入。

Released under the MIT License.