前言

.此帖子为windows解决方案，mac请参考：mac解决方案

windows的zip包，解压时间比较长，请勿中断！如中断了解压，请重新解压

Windows HBuilderX起不来，主要有两种：

新下载的起不来，请参考第一章
以前可以启动，后来起不来，请略过第一章，直接看第二章

1. 重点：新下载的HBuilderX无法启动

近来，部分小伙伴，反馈在windows系统上，新下载的HBuilderX，解压后，无法启动、点击无反应、启动报xxx.dll错误。

特别备注：HBuilderX，要求系统最低是win7，不支持xp

特别说明：如果您的电脑AMD显卡，请直接看2.3章节

1.0 问题：快捷方式引发的问题

windows, 部分小伙伴，解压zip后，为了创建快捷方式，把HBuilderX.exe直接拖动到桌面了，点击exe启动不了。

创建桌面快捷方式的正确姿势：

选中HBuilderX.exe，点击鼠标右键，出现菜单
点击菜单项：发送到
点击桌面快捷方式

1.1 问题现象1：缺少qt*库

解压后，点击HBuilderX.exe, 提示缺少qt5*.dll库
解压后，点击HBuilderX.exe, 提示无法定位输入点xxxxxxx于动态链接库xxx.dll上

示例截图：

解决方案

解压后，进入HBuilderX目录，进入bin目录，将bin目录下，所有除了api开头的dll文件，就是非api开头的dll文件，剪切到上一级目录。注意是剪切，不是复制。

or

进入HBuilderX目录下bin目录，找到弹框里面提到的dll文件，然后拷贝到System32或者SysWOW64文件夹

or

检查一下本机是否安装了qt，如以前安装过，进入环境变量，将qt相关的环境变量删除

1.2. 问题现象2：没有任何反应

解压后，点击HBuilderX.exe, 没有任何反应
解压后，点击HBuilderX.exe, HBuilderX进程启动，又马上关闭

尝试以下解决方案

关闭所有的杀毒软件后，启动试试
使用超级管理员启动试试
按照现象1的方案尝试一下
在HBuilderX.exe上，鼠标右键，点击属性。如下图所示操作：

1.3. 问题现象3：

如下图：

解决方案：检查一下本机是否安装了qt，如以前安装过，进入环境变量，将qt相关的环境变量删除

1.4 内存不能read

尝试方法：下载 opengl32sw.dll文件补丁，放到HBuilderX根目录

或：

请参考帖子（感谢贴主：爱不会绝记）：https://www.jianshu.com/p/109d15ec3895

修改系统环境变量，如下：

2. 通过事件查看器排查问题

如果以上的方案都没有解决您的问题，那就需要仔细查找原因了。

某些错误，会记录在【事件查看器】中。

打开事件查看器的方法：点击“开始→运行”，输入eventvwr，点击“确定”，就可以打开事件查看器。

如下图：点击【Windows 日志】—【应用程序】，找到级别为错误的记录，如是HBuilderX的记录，根据记录，解决问题

特别说明：如果事件查看器错误显示unKnow, 那就下载2.1 章节中的dll文件，即下载此 opengl32sw.dll文件补丁，放到HBuilderX根目录试试

下面罗列，【事件查看器】中可能会遇到的错误.

2.1 显卡错误：ig9icd32.dll错误

在事件查看器中，可能遇到ig9icd32.dll错误的解决办法

方法1：

升级显卡驱动

方法2：

下载此 opengl32sw.dll文件补丁

下载后，将此dll文件，放到HBuilderX`根目录

2.2 显卡错误：dbgcore.dll错误

在事件查看器中，可能遇到dbgcore.dll错误的解决办法

下载下面的dbgcore.dll到HBuilderX所在目录

dbgcore.dll下载地址

2.3 AMD显卡错误： atioglxx.dll错误

如果您的电脑配置了AMD显卡，很有可能启动不了。

atioglxx.dll是ati显卡驱动所需要的一个文件。

解决办法：

开始菜单，搜索【计算机管理】
点击【设备管理器】—> 【显示适配器】
如果有两块显卡，且其中一块为AMD，选中amd显卡，右键菜单，禁用。如果只有一块AMD显卡，就别禁用了。

2.4 【设备管理器】显卡上面出现叹号

部分类型的显卡，可能因为

开始菜单，搜索【计算机管理】
点击【设备管理器】—> 【显示适配器】
如果上面显示叹号，更新到最新版本。

2.5 更新显卡驱动后出现问题

如果您更新过显卡驱动，更新驱动之后，启动不了。那就是显卡驱动的问题。请还原显卡驱动，或升级驱动到最新版、或最新稳定版本。

3. 重点：以前能正常启动，突然启动不了

还有小伙伴反应，昨天还用的好好的，今天启动不了，怎么回事呢？

3.1 配置文件损坏

有可能是配置文件损坏了，导致无法启动。

先点击一下安装目录下的reset.bat文件
还不行，再试下如下方案：

进入`C:\Users\Administrator\AppData\Roaming\`目录，将`Administrator`换成你自己的用户  
在此目录下，找到HBuilder X目录，注意：将此目录随便重命名一下，也可以删除掉  
然后重启HX

4. 备注

4.1 联系方式

如果以上都尝试了，还未解决，请联系官方：

Email: ide@dcloud.io
QQ: 搜群，群关键字：HBuilderX ,加入群后，找群管理员帮您解决。
去论坛发帖。论坛地址：http://ask.dcloud.net.cn

HBuilderX无法启动排查指南

前言