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
- 若是压缩包:解压到
D:\Dev\HBuilderX,运行其中的HBuilderX.exe(绿色版,一般不用安装)。 - 若是安装程序:双击按向导 Next 完成,记住安装路径。
- 首次启动登录 DCloud 账号(可用手机号,免费)。
- 工具 → 插件安装:按需安装「uni-app 编译」「scss/sass」等(新建 uni-app 时一般会提示)。
2. 配置微信开发者工具路径(必做)
要「运行到微信开发者工具」,必须先装好微信开发者工具,再在 HBuilderX 里指定路径:
- 菜单:工具 → 设置 → 运行配置。
- 找到「微信开发者工具路径」,填入安装目录下的
cli.bat所在位置,例如:C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat - 微信开发者工具里:设置 → 安全设置 → 开启「服务端口」(旧版名称可能为「CLI / 服务端口」)。
- 回到 HBuilderX,打开 uni-app 项目 → 运行 → 运行到小程序模拟器 → 微信开发者工具。
提示:第一次运行会自动拉起微信开发者工具;若没反应,检查路径、服务端口、杀毒拦截。
3. HBuilderX 打开 UniApp 并真机 / 浏览器预览
- 文件 → 打开目录 → 选 UniApp 项目根目录(含
manifest.json、pages.json)。 - 运行到浏览器:可快速看 H5。
- 运行到微信开发者工具:联调小程序。
- 真机运行:手机与电脑同一 WiFi,按提示扫码;接口地址勿写
localhost,应写电脑局域网 IP。
更细的导入视频见本站「开发工具 → UniApp」页面。