uni-app 安装
2026/7/16小于 1 分钟
uni-app 安装
方式一：HBuilderX（推荐）
- 下载 HBuilderX
- 文件 → 新建 → 项目 → 选择 uni-app 模板
- 选择 Vue2 或 Vue3 版本
方式二：CLI 创建
# 全局安装 Vue CLI
npm install -g @vue/cli
# 创建 uni-app 项目
vue create -p dcloudio/uni-preset-vue my-project
# 或使用 npx
npx @dcloudio/uvm@latest create my-project
# 进入目录
cd my-project
# 安装依赖
npm install
# 运行到浏览器
npm run dev:h5
方式三：从模板创建
# 使用官方模板
git clone https://github.com/dcloudio/uni-app-quickstart.git
cd uni-app-quickstart
npm install
环境要求
| 工具 | 版本要求 |
|---|---|
| Node.js | 16+ |
| npm | 7+ |
| HBuilderX | 最新版 |
| Java | 8+ (Android 打包需要) |
| Android Studio | 最新版 (Android 打包需要) |
App 真机运行
- 手机连接电脑，开启 USB 调试
- HBuilderX 中点击运行 → 运行到手机
- 或使用 CLI：
npm run dev:app
常见问题
- 确保 HBuilderX 版本与编译器版本一致
- 如遇白屏，检查 manifest.json 中的应用配置
- 真机运行需安装对应手机驱动