plugin-uni

为 uni-app 提供的 原生 ESM Vite 插件,让你在 ESM-First 环境中零成本接入 uni-app 构建体系。

✨ 亮点

特性说明
🚀 原生 ESM完全遵循 import/export 规范,无需 .default() 适配
🛡️ 完整类型TypeScript 类型与 @dcloudio/vite-plugin-uni 同步,IDE 提示零丢失
🪶 零依赖转发通过 peerDependencies 复用用户项目中的官方插件,不锁版本
🧩 即装即用一行 import,即可替换官方 CJS 插件

📦 安装

npm
pnpm
bun
yarn
npm i -D @uni-helper/plugin-uni

🔧 使用

package.json
{
  "type": "module",
  "devDependencies": {
    "@dcloudio/vite-plugin-uni": "xxx",
    "@uni-helper/plugin-uni": "^0.1.0"
  }
}
vite.config.ts
import Uni from '@uni-helper/plugin-uni'
// vite.config.ts
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [
    Uni({ /* 同官方配置 */ })
  ]
})

⚙️ 工作原理

  1. 本包仅做 ESM 重导出CJS→ESM 兼容性语法糖,不携带任何运行时逻辑。
  2. 通过 peerDependencies 复用用户项目中的 @dcloudio/vite-plugin-uni,确保版本由用户掌控。
  3. 手动导出d.ts文件,确保类型与官方插件一致。