@dcloudio/vite-plugin-uni 是 CJS 包。在 ESM 配置里执行 import Uni from '@dcloudio/vite-plugin-uni',拿到的是整个 module.exports,还得自己再取一次 .default。
本包把这一步包好。它只做重导出,不包含运行时逻辑,也不限制官方插件的版本。
安装
官方插件 @dcloudio/vite-plugin-uni 必须自己安装。本包通过 peerDependencies 使用它。
npm i -D @uni-helper/plugin-uni使用
vite.config.ts
import Uni from '@uni-helper/plugin-uni'
import { defineConfig } from 'vite'
export default defineConfig({
plugins: [
Uni(),
],
})
配置按 ESM 写即可。playground 的 package.json 设置了 "type": "module"。
Uni() 的选项和官方插件相同:uvue、vueOptions、vueJsxOptions、viteLegacyOptions、autoImportOptions。需要类型时从 @dcloudio/vite-plugin-uni 导入。
工作原理
src/index.js只有一行export default uni.default ?? uni。官方插件带.default时取它,否则直接用导入结果。src/index.cjs是require条件的入口,写法相同:module.exports = uni.default ?? uni。src/index.d.ts重导出官方插件的默认类型。IDE 提示和官方插件保持一致。peerDependencies写的是*。官方插件用哪个版本由你的项目决定,本包不用跟着发版。
问题反馈
构建出错时,必须先确认是不是官方插件的问题。是的话提到 dcloudio/uni-app。
确认问题出在转发层,再到 uni-helper/plugin-uni 提 issue,并附上最小复现仓库。
官方插件提供原生 ESM 版本后,本包会归档并停止维护。