unibest · MiniApp Toolkit

特性

约定式路由（vite-plugin-uni-pages）
布局系统（vite-plugin-uni-layouts）
组件自动导入（vite-plugin-uni-components）
请求封装 + 拦截器
登录拦截 + 鉴权
UnoCSS 原子化样式
i18n 多语言
多 UI 框架可选（WotUI / uview-plus / NutUI 等）
CLI feature 按需添加（pnpm create unibest add i18n）
VS Code + WebStorm 双支持

详细文档

unibest — uni-app Vue3 最佳实践开发模板#

unibest 是 uni-app 生态中最受欢迎的 Vue3 开发模板，由 uniapp + Vue3 + TypeScript + Vite5 + UnoCSS + WotUI + z-paging 构成。它解决了 uni-app 项目初始化的痛点——开发者无需依赖 HBuilderX，通过命令行即可创建生产级项目，内置约定式路由、请求封装、登录拦截、i18n 等开发必备功能，让编写 uniapp 拥有「best」体验。

设计规范#

技术栈：Vue 3 + TypeScript + Vite 5 + UnoCSS
包管理：pnpm >= 9，Node >= 18
平台兼容：H5 / iOS / Android / 微信小程序 / 字节小程序 / 快手小程序 / 支付宝小程序 / 钉钉小程序 / 百度小程序（全平台覆盖）
编辑器：VS Code（推荐）或 WebStorm，支持代码提示和自动格式化
UI 框架：默认集成 WotUI，可选 uview-plus / NutUI / TMUI 等

审核规范#

unibest 是开发模板，不涉及小程序审核。但使用 unibest 创建的项目发布时需遵循各平台审核规范。

开发指南#

创建项目#

code

# 方式一：CLI 交互式创建（推荐）
pnpm create unibest my-project

# 方式二：指定 feature
pnpm create unibest my-project --i18n --login

# 方式三：克隆模板
git clone https://github.com/feige996/unibest.git my-project
cd my-project && pnpm install

CLI Feature 系统#

code

# 创建后按需添加 feature
cd my-project
pnpm create unibest add i18n      # 添加多语言
pnpm create unibest add login     # 添加登录策略
pnpm create unibest add i18n login  # 同时添加多个

项目结构#

code

my-project/
├── src/
│   ├── pages/          # 页面（约定式路由自动生成 pages.json）
│   ├── layouts/        # 布局组件
│   ├── components/     # 自动导入组件
│   ├── api/            # 请求封装
│   ├── store/          # 状态管理
│   ├── locale/         # i18n 多语言
│   └── static/         # 静态资源
├── pages.json          # 自动生成（勿手动编辑）
├── manifest.json       # 应用配置
├── vite.config.ts      # Vite 配置
└── uno.config.ts       # UnoCSS 配置

内置功能#

功能	实现	说明
约定式路由	vite-plugin-uni-pages	文件路径即路由，自动生成 pages.json
布局系统	vite-plugin-uni-layouts	多布局切换（默认/TabBar/自定义）
组件导入	vite-plugin-uni-components	组件免导入自动注册
请求封装	自封装 interceptor	统一错误处理 + Token 注入
登录拦截	路由守卫	白名单 + 重定向 + Token 刷新
原子化 CSS	UnoCSS	小程序兼容预设，类 Tailwind 体验

常见陷阱#

Node 版本：必须 node >= 18，低版本会报 ES2022 语法错误
pnpm 版本：必须 pnpm >= 9，否则 lockfile 不兼容
pages.json：使用约定式路由后不要手动编辑 pages.json，它会被自动覆盖
UI 框架切换：CLI 创建时选择 UI 框架后，切换需要手动调整依赖和配置
旧仓库迁移：codercup/unibest（原仓库）已不维护，所有 PR 和 Issue 请使用 feige996/unibest

生态资源#

文档站：unibest.tech
在线 DEMO：hello-unibest
npm 包：create-unibest（73 versions）
Gitee 镜像：feige996/unibest
关联工具：vite-plugin-uni-pages / vite-plugin-uni-layouts / WotUI / z-paging
同类模板：create-uni（uni-helper 官方脚手架）/ vitesse-uni-app（uni-helper 轻量模板）

版本更新#

create-unibest v4.0.16（2026-04-25）— 最新 CLI 版本，73 个 npm 版本
GitHub 活跃度：feige996/unibest 最后 push 2026-07-06；codercup/unibest 最后 push 2026-03-28
合并 stars：~5000+（feige996 2186⭐ + codercup 2858⭐）
平台声明：旧仓库 codercup/unibest 因权限问题已迁移至 feige996/unibest，star 无法迁移但新仓库持续维护中

支持平台