uniapp 配置环境

安装开发工具 HBuilderX

HBuilderX 是 uniapp 官方推荐的开发工具，支持 Windows 和 macOS 系统。

• 下载地址：HBuilderX 官网
• 选择适合操作系统的版本下载并安装。
• 安装完成后启动 HBuilderX，首次使用可能需要登录 DCloud 账号。

安装 Node.js

uniapp 依赖 Node.js 环境，主要用于包管理和构建项目。

• 下载地址：Node.js 官网
• 建议安装 LTS（长期支持）版本，确保稳定性。
• 安装完成后，在终端运行以下命令验证安装：

  node -v
  npm -v

配置微信开发者工具（如需开发小程序）

uniapp 支持编译到微信小程序，需提前安装微信开发者工具。

• 下载地址：微信开发者工具
• 安装完成后，打开工具并登录微信开发者账号。
• 在 HBuilderX 中配置工具路径：
  进入 HBuilderX -> 设置 -> 运行配置，填写微信开发者工具的安装路径。

创建 uniapp 项目

• 在 HBuilderX 中选择 文件 -> 新建 -> 项目。
• 选择 uni-app 模板，填写项目名称和存储路径。
• 根据需求选择默认模板或自定义模板（如 Vue2/Vue3）。

安装依赖与运行项目

• 在项目根目录下运行以下命令安装依赖：

  npm install

• 在 HBuilderX 中选择运行方式（浏览器、小程序模拟器等），点击运行按钮即可启动项目。

配置其他平台（可选）

如需开发其他平台（如 App、H5），需安装对应平台的开发工具或模拟器：

• App 开发：需安装 Android Studio 或 Xcode（iOS）。
• H5 开发：直接通过浏览器运行，无需额外配置。

调试与发布

• 使用 HBuilderX 内置的调试工具或浏览器开发者工具进行调试。
• 发布时，通过 HBuilderX -> 发行 选择目标平台生成打包文件。

常见问题

• Node.js 版本问题：建议使用 Node.js 14.x 或 16.x，避免兼容性问题。
• 微信开发者工具路径：确保路径无中文或特殊字符。
• 网络问题：如 npm 安装失败，可切换淘宝镜像：

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