uni-halo/.agents/bak-skills/uniapp-project-creator/examples/guide/installation.md

uni-app 安装指南

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/quickstart-cli.html

安装方式

方式一：使用 HBuilderX（推荐新手）

HBuilderX 是 DCloud 官方提供的 IDE，内置 uni-app 开发环境。

下载安装：

1. 访问 https://www.dcloud.io/hbuilderx.html
2. 下载 HBuilderX（标准版或 App 开发版）
3. 安装并启动 HBuilderX

创建项目：

1. 文件 → 新建 → 项目
2. 选择 uni-app
3. 选择模板（默认模板、uni-ui 项目模板等）
4. 填写项目名称和路径
5. 点击创建

方式二：使用 Vue CLI（推荐有经验开发者）

安装 Vue CLI：

# 全局安装 Vue CLI
npm install -g @vue/cli

# 检查版本
vue --version

创建 uni-app 项目：

# 使用官方预设模板
vue create -p dcloudio/uni-preset-vue my-project

# 或使用 degit（更快）
npx degit dcloudio/uni-preset-vue my-project

选择 Vue 版本：

• Vue 2：稳定版本，兼容性好
• Vue 3：最新版本，性能更好

方式三：使用官方 CLI（uni-app CLI）

# 安装 uni-app CLI
npm install -g @dcloudio/uvm
uvm

# 创建项目
npx degit dcloudio/uni-preset-vue my-project

环境要求

Node.js 版本

• 推荐版本：Node.js 14.x 或更高版本
• 最低版本：Node.js 12.x

# 检查 Node.js 版本
node --version

# 检查 npm 版本
npm --version

其他工具

• 微信开发者工具：用于开发微信小程序
• Android Studio：用于开发 Android App
• Xcode：用于开发 iOS App（仅 macOS）

验证安装

创建项目后，验证安装是否成功：

cd my-project
npm install
npm run dev:h5

如果浏览器自动打开并显示 uni-app 欢迎页面，说明安装成功。

常见问题

1. npm 安装慢

使用国内镜像：

npm config set registry https://registry.npmmirror.com

2. Vue CLI 版本问题

确保使用最新版本：

npm update -g @vue/cli

3. HBuilderX 无法创建项目

检查 HBuilderX 版本，确保是最新版本。

下一步

安装完成后，参考 quick-start.md 开始创建第一个项目。