为什么Uniapp项目运行到快应用联盟开发工具一直显示编译中

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

针对你遇到的 uni-app 项目运行到快应用联盟开发工具一直显示“编译中”的问题，结合你的描述“代码本身没有问题，刚新建的新项目，配置文件也做了配置，但其他平台（Web、App、微信小程序）均可正常编译”，这种情况通常不是代码逻辑错误，而是快应用开发环境或 uni-app 编译器配置相关的问题。

以下是一些排查和解决的建议：

1. 检查快应用联盟 IDE 的版本和项目名称
根据 uni-app 官方文档的明确要求：

• IDE 版本：华为快应用 IDE 的最低版本要求是 2.5.2。如果你的版本过低，可能会导致编译异常，建议更新到最新版。
• 项目名称：已知 2.5.2 版本的工具有一个 Bug，即不支持项目名称中包含空格。请检查你的项目路径和名称是否包含空格，如有，请移除空格后重试。

2. 确认“运行”与“发行”的区别
在 HBuilderX 中，将项目运行到快应用开发工具有两种方式：

• 运行：顶部菜单 -> “运行” -> “运行到小程序模拟器” -> “快应用联盟开发者工具”。此模式用于日常开发调试。
• 发行：顶部菜单 -> “发行” -> “快应用联盟”。此模式用于打包正式版，会在 unpackage/dist/build/quickapp-webview 目录下生成项目代码，然后需要手动导入到快应用联盟工具中。

建议你检查 HBuilderX 的控制台日志，看编译过程是否真的完成，并确认是通过哪种方式操作的。可以尝试“发行”后，在快应用联盟开发工具中手动导入生成的工程，看是否能被正常识别和构建。

3. 尝试清理编译缓存
缓存问题可能导致编译器状态异常。可以尝试删除项目根目录下的 unpackage 文件夹，然后重新运行。

4. 检查 manifest.json 中的快应用配置
确保 manifest.json 中“快应用联盟”的配置项完整且正确，特别是 AppID、最小平台版本号（最小平台版本支持需要 1070）等基础信息。虽然你说配置文件做了配置，但可以重点检查一下这些必填项是否已填写。

5. 检查 PC 端网络与开发者工具状态
快应用联盟开发工具在编译时可能需要联网加载一些依赖。可以检查一下开发工具本身是否有更新，或者暂时关闭防火墙/杀毒软件后重试。

如果以上步骤均无法解决问题，可以尝试在快应用联盟开发工具中查看更详细的编译日志，通常工具底部的“输出”或“终端”面板会提供更具体的错误信息，有助于进一步定位。