create-uni
工具uni-app 官方社区生态组织 uni-helper 维护的快速脚手架工具。支持交互式或命令行模式创建 uni-app 项目，内置 8+ 模板、6+ 插件、多 UI 组件库选择，集成 TypeScript / ESLint / Pinia 等现代开发工具链。
脚手架uni-appVue3Viteuni-helperTypeScript项目模板
详细文档
create-uni#
平台概述#
create-uni 是 uni-helper 社区组织维护的 uni-app 项目脚手架工具，类似 Vue 生态中的 create-vue。它帮助开发者通过交互式命令行或一行命令快速创建配置完善的 uni-app 项目。
核心价值：uni-app 官方 HBuilderX IDE 创建的项目默认使用 Webpack 和 Vue 2，而现代 uni-app 开发已转向 Vite + Vue 3。create-uni 解决了「如何快速搭建一个现代化的 uni-app 项目」这一痛点，内置模板覆盖主流 UI 库和工具链组合。
项目数据（2026-07-31 核实）：
- GitHub：301⭐ / 20 forks
- npm：
create-univ2.15.0，141 个版本（2023-06 至今） - 最近活跃：2026-07-27（持续高频迭代）
- 维护方：uni-helper 社区组织
设计规范#
命令行参数#
| 参数 | 别名 | 说明 | 可选值 |
|---|---|---|---|
--template | -t | 项目模板 | 见模板列表 |
--ts | — | 启用 TypeScript | — |
--pluginList | -p | 安装插件 | 见插件列表 |
--moduleList | -m | 安装模块 | pinia / uniUse 等 |
--ui | -u | 选择 UI 组件库 | 见 UI 列表 |
--eslint | -e | 启用 ESLint | — |
--gui | — | 图形化界面 | — |
--info | — | 输出环境信息 | — |
内置模板#
| 模板 | 说明 | 参数名 |
|---|---|---|
| vitesse-uni-app | Vite + uni-app 跨端快速启动模板 | vitesse |
| wot-starter | 基于 vitesse-uni-app 的 wot-ui 起手模板（v1） | wot-starter |
| wot-starter-v2 | wot-ui v2 快速起手模板 | wot-starter-v2 |
| wot-starter-retail | 基于 wot-ui 的零售行业模板 | wot-starter-retail |
| uview-pro-starter | uView Pro 快速启动模板 | uview-pro-starter |
| uview-pro-demo | uView Pro 完整组件演示 | uview-pro-demo |
| unisave | 适配所有平台（app/mp/web） | unisave |
| tmui 3.2 | Vue3 TS Pinia Vite 跨端组件库 | tmui32 |
内置插件#
| 插件 | 说明 | 参数名 |
|---|---|---|
| vite-plugin-uni-components | 按需自动引入组件 | import |
| vite-plugin-uni-pages | 基于文件系统的路由 | pages |
| vite-plugin-uni-layouts | 类 Nuxt 的布局系统 | layouts |
| vite-plugin-uni-manifest | 自动生成 manifest.json | manifest |
| vite-plugin-uni-platform | 基于文件名的平台条件编译 | platform |
UI 组件库选项#
- wot-design-uni：2275⭐ Vue3 + TS 组件库
- ano-ui：uni-app 原子化 CSS 组件库
- uview-plus：711⭐ uView 2.0 活跃 fork
审核规范#
不涉及（开发工具，不影响小程序审核流程）。
开发指南#
快速上手#
# 方式1：交互式创建（推荐新手）
npm create uni@latest
# 或
pnpm create uni
# 方式2：一行命令创建（推荐老手）
pnpm create uni my-app --ts -m pinia -m uniUse -u ano -e
# 方式3：图形化界面
pnpm create uni --gui
生成的项目结构#
my-app/
├── src/
│ ├── pages/ # 页面（配合 vite-plugin-uni-pages 自动路由）
│ ├── layouts/ # 布局（配合 vite-plugin-uni-layouts）
│ ├── components/ # 组件（配合 vite-plugin-uni-components 自动导入）
│ ├── composables/ # 组合式函数
│ ├── stores/ # Pinia 状态管理
│ ├── static/ # 静态资源
│ └── App.vue
├── pages.config.ts # pages.json 配置（类型安全）
├── manifest.config.ts # manifest.json 配置（类型安全）
├── vite.config.ts # Vite 配置
├── tsconfig.json
├── .eslintrc # ESLint 配置（可选）
└── package.json
与 HBuilderX 项目的区别#
| 特性 | HBuilderX 项目 | create-uni 项目 |
|---|---|---|
| 构建工具 | Webpack | Vite |
| Vue 版本 | Vue 2 / Vue 3 | Vue 3 |
| 路由管理 | 手动 pages.json | 文件路由（自动生成） |
| 组件导入 | 手动 import | 自动导入 |
| TypeScript | 可选 | 默认推荐 |
| ESLint | 手动配置 | 一键启用 |
| 状态管理 | Vuex / 手动 | Pinia |
常见陷阱#
- @latest 标记：使用
npm create uni@latest而非npm create uni，否则 npm 可能解析到缓存的过时版本 - HBuilderX 兼容性：create-uni 生成的项目是 Vite 项目，可以用 HBuilderX 打开但不是 HBuilderX 项目格式
- 模板版本：模板中引用的 UI 库版本可能不是最新（如 wot-starter 模板使用 wot v1，v2 需选 wot-starter-v2）
- pnpm 推荐使用：uni-app + Vite 生态对 pnpm 支持最好，npm/yarn 可能有 peer dependency 问题
生态资源#
uni-helper 组织工具集#
| 项目 | 说明 | Stars |
|---|---|---|
| vite-plugin-uni-pages | 文件路由插件 | 204⭐ |
| vite-plugin-uni-layouts | 布局系统插件 | 66⭐ |
| vite-plugin-uni-components | 组件自动导入 | 100+⭐ |
| uni-use | Vue 3 组合式工具集 | 182⭐ |
| unocss-preset-uni | UnoCSS uni-app 预设 | 126⭐ |
| uni-typed | TypeScript 类型支持 | 86⭐ |
| vitesse-uni-app | 快速启动模板 | 567⭐ |
推荐 UI 组件库#
- wot-design-uni：Vue3 + TS，70+ 组件，暗黑模式（2275⭐）
- uview-plus：uView 2.0 fork，60+ 组件，全端兼容（711⭐）
- uni-ui：DCloud 官方 UI 库，40+ 组件（2089⭐）
社区资源#
- GitHub Issues：3 个开放问题
- npm：141 个版本，持续迭代
版本更新#
当前状态（2026-07-31 核实）#
- GitHub：301⭐ / 20 forks
- npm：v2.15.0，141 个版本
- 维护方：uni-helper 社区组织
- 最近推送：2026-07-27
- 创建日期：2023-06-27
迭代频率#
- 141 个 npm 版本（2023-06 至 2026-04），平均每周 1 个版本
- 持续跟进 uni-app / Vite / Vue 3 生态更新
- 模板和插件列表随生态演进持续扩充
核实记录#
- 2026-07-31：GitHub API + npm registry 核实，301⭐ / v2.15.0 / 141 versions / 最后推送 2026-07-27，状态活跃。uni-helper 组织同时维护 10+ 个 uni-app 生态工具。
