快速开始

前置依赖
- Node.js - >=v20 (我的是 v22.13.0)
- pnpm - >=9+ (我的是 10.11.0)
- VSCode - 可选 WebStorm
- HBuilderX - APP 的运行和发布还是离不开它

创建项目

2025-11-04 开发了新版的 create-unibest@v3，对生成的项目进行了精简，并且对配置型进行了优化。可以自行选择想要的平台和 UI 库等。
如果想用旧版的 create-unibest@v2，则可以添加 @v2 后缀，例如 pnpm create unibest@v2 <项目名称>。

新版 create-unibest@v3 通过下面的命令可以快速生成项目模板:

pnpm create unibest new <项目名称>

如果执行 pnpm create unibest，则会打印帮助信息，等同 pnpm create unibest -h。

实际操作如下：

有 new 关键字，则进入创建项目流程。

text

feige996 ~ % pnpm create unibest new
┌  create-unibest@v3.1.0 快速创建 unibest@v4.1.0 项目
│
◇  请输入项目名称[项目名称只能包含字母、数字、下划线和短横线，千万别写中文]
│  uni-demo
│
◆ 请选择需要支持的平台（多选）[脚手架将根据所选平台生成对应的平台代码，请根据实际情况选择]
│  ◼ H5
│  ◻ 微信小程序
│  ◻ APP
│  ◻ 支付宝小程序（包含钉钉）
│  ◻ 抖音小程序
│
◆  请选择UI库
│  ● 无UI库
│  ○ wot-ui
│  ○ uview-pro
│  ○ sard-uniapp
│  ○ uv-ui
│  ○ uview-plus
◆  是否需要登录策略（黑白名单、登录拦截等）？[暂不知道的，选No即可，项目生成后也可以加该策略]
│  ○ Yes / ● No
◆  是否需要多语言i18n？
│  ○ Yes / ● No
◆  项目uni-demo创建成功！

没有 new 关键字，则打印帮助信息。

txt

feige996 ~ % pnpm create unibest
 WARN  1 deprecated subdependencies found: node-domexception@1.0.0
.../19ad2678dfe-1611                     |  +25 +++
.../19ad2678dfe-1611                     | Progress: resolved 25, reused 25, downloaded 0, added 25, done

create-unibest - 跨平台开发框架脚手架

全局安装:
  npm i -g create-unibest                    全局安装，得到 best 命令
  npm update -g create-unibest               更新 create-unibest 包

  best <command> [options]
  best new my-project                        创建新的unibest项目
  best -v                                    查看版本信息
  best -h                                    查看帮助信息


临时使用:
  pnpm create unibest <command> [options]
  pnpm create unibest new my-project         创建新的unibest项目
  pnpm create unibest -v                     查看版本信息
  pnpm create unibest -h                     查看帮助信息

安装、运行

bash

pnpm i
pnpm dev     # 运行h5
pnpm dev:mp  # 运行微信小程序
pnpm dev:app # 运行App

pnpm dev 之后在浏览器打开 http://localhost:9000/。

其他平台构建和发布，查看运行发布篇。

第一次 `commit`

bash

git add .
git commit -m "feat: init project"

必看章节

uni 插件篇和常见问题

`v3` 代码块

在 vue 文件中，输入 v3 按 tab 即可快速生成页面模板，可以大大加快页面生成。

原理：基于 VSCode 代码块生成。

alt text

注意事项

若代码里面自动引入的 API 报错，只需要 pnpm dev 即可。
若代码运行后，H5端 浏览器界面底部没有 tabbar，刷新浏览器或者再次 pnpm dev 即可。

项目仓库地址

github 和 gitee 实时同步，代码一致。

普通模板：

demo 模板是在 hello-unibest 项目中，仓库地址如下：

未来 github 上的仓库都可能迁移到 unibest-tech 组织下。

快速开始 ​

创建项目 ​

安装、运行 ​

第一次 commit ​

必看章节 ​

v3 代码块 ​

注意事项 ​

项目仓库地址 ​

普通模板： ​