常见问题

本页汇总 HBuilder V 使用过程中的常见问题。如果这里没有解决你的问题，可以通过 帮助 > Bug上报 提交反馈。

插件

在插件市场搜索不到插件怎么办？

编辑器插件市场基于 Open VSX。请先确认网络可以访问插件市场；如果使用代理，请在设置中配置网络代理后重启 HBuilder V。

插件安装失败或一直转圈怎么办？

• 检查网络与代理设置；
• 换用离线 VSIX 方式安装，详见 插件安装；
• 安装完成后如果功能没有生效，执行 开发人员: 重新加载窗口。

如何安装指定版本的插件？

从 Open VSX 的插件页面下载对应版本的 VSIX 包，然后通过扩展视图右上角 ... > 从 VSIX 安装... 安装。

提示版本不匹配?

HBuilder V 的核心插件与编辑器版本是强制绑定的：每个 HBuilder V 版本都要求使用与之对应的核心插件版本，两者需要一一匹配。当核心插件版本与当前 HBuilder V 版本对不上时，启动或使用相关功能就会提示“版本不匹配”。

出现这个提示，最常见的原因是覆盖安装。如果你之前已经装过 HBuilder V，之后没有走升级流程，而是直接下载新版本安装包做覆盖安装，那么安装包只会更新 HBuilder V 本身，不会覆盖核心插件目录，目录中仍是上一版本的核心插件。编辑器（HBuilder V）已经是新版本、插件还是旧版本，版本校验不通过，于是提示版本不匹配。

处理方式：

• 按提示引导完成核心插件的升级或重装，插件更新到与当前 HBuilder V 匹配的版本后即可恢复正常；
• 如果引导流程没有自动完成，可以在扩展视图中卸载核心插件后重新安装，或参考 离线安装 VSIX 手动安装与当前 HBuilder V 匹配的 VSIX 包；
• 安装完成后如果功能仍未生效，执行 开发人员: 重新加载窗口 再试。

为避免再次出现：后续升级请走应用内的检查更新或官方升级流程，不要用覆盖安装代替升级。

运行与发行

找不到手机或模拟器设备怎么办？

• 确认设备已连接，并已开启开发者模式与 USB 调试；
• Android 设备可检查设置中的 ADB 路径是否正确；
• 重新插拔设备或重启 ADB 后重试。

运行到小程序没有反应怎么办？

确认对应的开发者工具已安装并能正常打开，并在设置中配置了正确的开发者工具路径。

编译失败如何定位问题？

查看 运行控制台 中的编译输出，第一条错误通常最能说明问题；也可以查看 输出 面板中对应的输出通道。

云打包失败怎么办？

查看 云端打包 输出通道中的日志；常见原因是证书、包名配置错误或账号登录状态失效。

账号与许可

如何登录 DCloud 账号？

在 HBuilder V 中打开账号入口并按提示完成登录授权。登录后才能使用云打包、uni-agent 订阅等依赖 DCloud 账号的能力。

uni-agent 提示“小助手接口未配置”怎么办？

该功能目前仅对订阅账号开放，请确认当前登录的 DCloud 账号已订阅 uni-agent。

HBuilder V 的许可协议在哪里查看？

可以使用 帮助 > 查看许可证 查看使用许可协议；相关说明也可以参考 LICENSE。