[社区投票] 推进 uni-helper 工具链全面支持 ESM 规范

[FliPPeDround]

ESM 支持的必要性与 Uni 生态演进方案

背景：Vite 生态的 ESM 转型趋势

随着 Vite 架构演进，其最新版本已全面采用 ESM（ECMAScript Modules) 规范。当前 Vite 生态中除 uni 相关插件外，所有核心工具链均已实现 ESM 原生支持。在此技术演进背景下，为兼容 uni 插件的 CommonJS (CJS) 格式而放弃 ESM 优势，将导致显著的开发成本与生态割裂。

---

ESM 环境中引入 Uni-app CJS 插件的方式

import Uni from '@dcloudio/vite-plugin-uni';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [
    Uni.default(), // 需显式调用 default 属性
  ],
});

当前方案存在的核心问题：

1. 类型系统失效：TS 类型推断中断，丧失静态检查能力
2. 违反直觉的接入方式：.default() 调用增加认知负担
3. 生态兼容性风险：与 Vite 的 ESM 优先设计原则冲突

解决方案

由uni-helper社区维护ESM的uni插件
标准化解决方案：@uni-helper 的 ESM 生态体系

import Uni from '@uni-helper/plugin-uni'; // 符合 ESM 规范的标准导入

export default defineConfig({
  plugins: [Uni()] 
});

核心优势：

• ✅ 原生 ESM 导出：符合标准的模块导出规范
• ✅ 完整的类型声明：开箱即用的 TypeScript 支持
• ✅ 符合直觉的 API：消除不必要的适配代码

@uni-helper 的 ESM 兼容工具链

为构建完整的 ESM 开发体验，社区同步推进以下核心工具：

模块	功能	状态	进展跟踪
@uni-helper/plugin-uni	由uni-helper社区维护ESM的uni插件	🚀 DONE
vite-plugin-uni-pages	自动化页面路由系统	🚀 DONE	uni-helper/vite-plugin-uni-pages#208
vite-plugin-uni-platform	多平台构建解决方案	🚀 DONE	uni-helper/vite-plugin-uni-platform#6

协作邀请：当前工具链在 ESM 边界场景仍存在兼容性问题，诚邀开发者通过 PR 共同完善

[sunpm]

uniapp 真能支持 ES module 吗？现在控制台警告我没理他😂

[FliPPeDround]

uniapp 真能支持 ES module 吗？现在控制台警告我没理他😂

按照上面修改引入方式是可以的

[sunpm]

dcloudio/uni-app#4815 (comment)
Uni.default() 确实可以，只是不知道 uniapp 为啥不解决，还 closed

[lsrweb]

全面落实ESM科学发展观

[aloniacode]

都5202年了，还有不支持ESM的生态，我大为震惊。👀

WE NEED ESM!!!
WE NEED ESM!!!
WE NEED ESM!!!
WE NEED ESM!!!
WE NEED ESM!!!
WE NEED ESM!!!