Create UniApp CLI

UniApp 项目脚手架工具，快速创建跨平台小程序项目。

功能特性

• 🚀 快速创建 UniApp 项目
• 📦 支持多种模板（Vue3 + Vite / Vue3 + Vite + TypeScript）
• 🎨 交互式命令行界面
• ✅ 项目名称验证
• 🔄 自动检测目录冲突
• 📥 自动下载官方模板
• 🛠️ 自动安装依赖

安装

npm install -g create-uniapp-cli

使用方法

创建项目

create-uniapp [项目名称]

命令选项

| 选项 | 简写 | 说明 | 默认值 | |------|------|------|--------| | --template | -t | 模板类型 (vue3-vite|vue3-vite-ts) | vue3-vite-ts | | --force | -f | 强制覆盖已存在的目录 | false |

示例

使用默认模板创建项目：

create-uniapp my-project

使用 TypeScript 模板：

create-uniapp my-project -t vue3-vite-ts

强制覆盖已存在的目录：

create-uniapp my-project -f

交互式创建

如果不指定项目名称，CLI 会提示输入：

create-uniapp

然后按提示选择模板和输入项目名称。

模板说明

| 模板 | 名称 | 描述 | |------|------|------| | vue3-vite | Vue3 + Vite | 官方 Vue3 + Vite 模板，轻量快速 | | vue3-vite-ts | Vue3 + Vite + TypeScript | Vue3 + Vite + TypeScript 模板 |

项目名称规则

• 只能包含字母、数字、- 和 _
• 不能为空

创建后操作

项目创建成功后，进入项目目录启动开发：

cd <项目名称>

# H5 开发模式
npm run dev:h5

# 微信小程序开发
npm run dev:mp-weixin

技术栈

• Commander.js - 命令行参数解析
• Inquirer.js - 交互式命令行
• Ora - 加载动画
• Chalk - 终端颜色输出
• Execa - 进程执行
• fs-extra - 文件系统操作
• Git - 从 Gitee 下载官方模板

License

MIT

相关链接

• UniApp 官方文档
• UniApp GitHub