WXS 配置
WXS（WeiXin Script）是小程序模板里用到的一种脚本语言。它能力有限、语法也和 JS 不完全一样。
weapp-vite 在尽量兼容的前提下，给 WXS 做了一些增强（例如更现代的语法支持、按需编译等）。你可以通过 weapp.wxs 一键开启/关闭这些增强。
weapp.wxs
- 类型：
boolean - 默认值：
true - 适用场景：
- 想用更现代的语法写 WXS，并交给构建器转成原生可运行代码。
- 调试时希望先回到“开发者工具默认行为”，排除构建器增强带来的影响。
配置示例
ts
import { defineConfig } from 'weapp-vite/config'
export default defineConfig({
weapp: {
wxs: true, // 默认即为 true，可显式声明便于团队理解
},
})若希望关闭增强，保留最基础的语法，可以将该选项设为 false：
ts
export default defineConfig({
weapp: {
wxs: false,
},
})常见问题
- 模板里使用新语法报错？ 请确认
wxs开关已开启，同时确保文件后缀为.wxs。weapp-vite 会自动将其纳入构建流程。 - 需要调试原始代码？ 临时关闭
wxs后重新运行pnpm dev，产物会尽量回退到原生行为，方便定位问题。 - 与第三方工具冲突？ 某些内网或历史项目可能依赖旧版编译行为，可在短期内关闭增强，并结合 共享配置 的调试钩子逐步迁移。
调试建议
- 观察产物：在
dist/中查看编译后的.wxs文件，确认是否包含期望的语法转换。 - 配合
watchFiles：通过weapp.debug.watchFiles输出监听列表，确保对应.wxs已被收集处理。 - 分包排查：若分包中引用的
.wxs未更新，可检查分包根目录是否命中srcRoot配置，详见 基础目录与资源收集。