Worker 配置

如果你的 app.json 里用了 workers（小程序 Worker），就需要确保 Worker 的入口脚本也能被正常编译并输出到 dist/。

weapp-vite 用 weapp.worker 来配置 Worker 入口（必要时可以多个），让 Worker 也能复用同一套 TS/别名/依赖分析能力。

• weapp.worker
  • 配置示例
  • 常见问题

weapp.worker

• 类型：

  {
    entry?: string | string[]
  }

• 默认值：undefined
• 适用场景：
  • 项目中存在长耗时计算、图像处理、压缩等任务，需要在 Worker 中运行。
  • 希望 Worker 也交给 weapp-vite 编译，复用 TS、别名与依赖分析逻辑。

配置示例

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

export default defineConfig({
  weapp: {
    worker: {
      entry: ['src/workers/image.ts', 'src/workers/audio.ts'],
    },
  },
})

构建时 weapp-vite 会：

1. 解析 entry 列表，生成 Worker 构建上下文。
2. 将产物输出到与主包一致的 dist/ 目录，并确保 workers 引用的路径可用。
3. 支持 TypeScript/ESM/别名等常用写法，让 Worker 的开发体验尽量和主包一致。

常见问题

• 未指定 entry 会怎样？ 如果 weapp.worker 未配置，weapp-vite 默认不会额外处理 Worker，仍可手动在 dist 目录放置脚本，但无法享受自动编译。
• Worker 能使用 npm 依赖吗？ 可以，weapp-vite 会复用 Vite 库模式处理 npm 包；若 Worker 依赖特定库，请确认在 dependencies 中已声明。
• 如何调试 Worker 构建？ 可结合 weapp.debug 输出 watchFiles、resolveId 日志，确认 Worker 脚本是否命中构建。

---

若尚未配置分包，推荐先阅读 分包配置 了解 weapp.subPackages 的使用方式，以便在 Worker 与分包同时存在时保持目录结构一致。