7. HBuilderX(UniApp)

本章共 3 篇详细教程(含 .msi / .exe 一键安装步骤),建议按顺序完成。安装包见「开发工具」各项目页网盘。

1. HBuilderX 安装(解压即用 / 安装包,推荐 4.8.7)

UniApp 项目主要在 HBuilderX 里运行。推荐使用安装包内 HBuilderX 4.8.7。

安装包下载:/tools/springboot3-vue3

官网下载:https://www.dcloud.io/hbuilderx.html

  1. 若是压缩包:解压到 D:\Dev\HBuilderX,运行其中的 HBuilderX.exe(绿色版,一般不用安装)。
  2. 若是安装程序:双击按向导 Next 完成,记住安装路径。
  3. 首次启动登录 DCloud 账号(可用手机号,免费)。
  4. 工具 → 插件安装:按需安装「uni-app 编译」「scss/sass」等(新建 uni-app 时一般会提示)。

2. 配置微信开发者工具路径(必做)

要「运行到微信开发者工具」,必须先装好微信开发者工具,再在 HBuilderX 里指定路径:

  1. 菜单:工具 → 设置 → 运行配置。
  2. 找到「微信开发者工具路径」,填入安装目录下的 cli.bat 所在位置,例如:
    C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat
  3. 微信开发者工具里:设置 → 安全设置 → 开启「服务端口」(旧版名称可能为「CLI / 服务端口」)。
  4. 回到 HBuilderX,打开 uni-app 项目 → 运行 → 运行到小程序模拟器 → 微信开发者工具。

提示:第一次运行会自动拉起微信开发者工具;若没反应,检查路径、服务端口、杀毒拦截。

3. HBuilderX 打开 UniApp 并真机 / 浏览器预览

  1. 文件 → 打开目录 → 选 UniApp 项目根目录(含 manifest.json、pages.json)。
  2. 运行到浏览器:可快速看 H5。
  3. 运行到微信开发者工具:联调小程序。
  4. 真机运行:手机与电脑同一 WiFi,按提示扫码;接口地址勿写 localhost,应写电脑局域网 IP。

更细的导入视频见本站「开发工具 → UniApp」页面。