快速开始
前置依赖
Node.js->=v20(我的是v22.13.0)Pnpm->=9(我的是10.11.0)VSCode- 可选其他IDE:Trae、Cursor、WebStorm等HBuilderX-APP的运行和发布离不开它Git- 必须有git,否则husky会报错
使用方式
方式一:通过 CLI 创建新项目(推荐)
通过 CLI 创建项目是推荐的方式,可以选择平台、UI 库、登录策略、多语言等配置。
bash
# 全局安装 CLI
pnpm add -g create-unibest
# 创建项目
pnpm create unibest my-project
cd my-project
pnpm install
pnpm devCLI 会从 Git base 分支克隆基础模板。
方式二:创建时选择 Feature
bash
# 创建项目并选择功能
pnpm create unibest my-project
# 或通过命令行参数直接指定
pnpm create unibest my-project --i18n --login --lime-echart --ucharts方式三:创建后添加 Feature
bash
cd my-project
# 添加多语言
pnpm create unibest add i18n
# 添加登录策略
pnpm create unibest add login
# 添加图表库
pnpm create unibest add lime-echart
pnpm create unibest add ucharts
# 同时添加多个
pnpm create unibest add i18n login lime-echart ucharts安装、运行
bash
pnpm i
pnpm dev # 运行h5
pnpm dev:mp # 运行微信小程序
pnpm dev:app # 运行Apppnpm dev 之后在浏览器打开 http://localhost:9000/。
其他平台构建和发布,查看 运行发布篇。
第一次 commit
bash
git add .
git commit -m "feat: init project"v3 代码块
在 vue 文件中,输入 v3 按 tab 即可快速生成页面模板,可以大大加快页面生成。
原理:基于
VSCode代码块生成。

注意事项
- 若代码里面自动引入的
API报错,只需要pnpm dev即可。 - 若代码运行后,
H5端浏览器界面底部没有tabbar, 刷新浏览器或者再次pnpm dev即可。
项目仓库地址
github 和 gitee 实时同步,代码一致。

