构建输出与兼容

weapp-vite 默认输出 CommonJS，并保持编译目标在 ES2015 及以上。若需要在旧机型上运行，可额外启用内置的 ES5 降级能力；而当你准备拥抱原生 ESM 时，也可以一键切换输出格式。

• weapp.jsFormat
  • 输出行为
• weapp.es5
  • 使用须知

weapp.jsFormat

• 类型：'cjs' | 'esm'
• 默认值：'cjs'
• 适用场景：
  • 沿用 CommonJS 管线，结合微信开发者工具的「ES6 转 ES5」即可兼容旧环境；
  • 需要直接产出 ESM 并利用更现代语法能力时，将其切换为 'esm'。

import { defineConfig } from 'weapp-vite/config'

export default defineConfig({
  weapp: {
    jsFormat: 'esm',
  },
})

输出行为

• cjs（默认）：输出 CommonJS，编译目标不少于 ES2015。若项目需要向 ES5 降级，可继续阅读下方的 weapp.es5 配置。
• esm：输出 ESM，产物仍为 ES2015+。请在 微信开发者工具 → 本地设置 中勾选「ES6 转 ES5」，以便开发者工具在预览/上传阶段完成降级。

注意：weapp-vite 会在解析配置时校验 build.target，若显式指定的值低于 ES2015（例如 es5 / es2014），将直接报错。仅当启用 weapp.es5 时才允许进行 ES5 降级。

weapp.es5

• 类型：boolean
• 默认值：false
• 适用场景：需要在非常旧的运行环境中执行 CommonJS 产物，并希望在构建阶段完成 ES5 降级。

import { defineConfig } from 'weapp-vite/config'

export default defineConfig({
  weapp: {
    jsFormat: 'cjs',
    es5: true,
  },
})

使用须知

• 仅当 jsFormat === 'cjs' 时有效；若与 esm 联用会抛出配置错误。
• 依赖 @swc/core 完成降级，请先安装：pnpm add -D @swc/core。
• 启用后，构建流程会强制将 bundler 目标锁定为 es2015，并在产物流出前使用 SWC 转换为 ES5。

提示：即便开启了 weapp.es5，仍建议在微信开发者工具中保持「ES6 转 ES5」开启，以降低真机/预览阶段的潜在差异。

---

完成配置后，建议重新执行 pnpm build，并在微信开发者工具中验证调试、预览与上传流程是否符合预期。