uniapp vue3 生成鸿蒙版本

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

看到你被 uni-app 打包鸿蒙的问题折磨了，非常理解这种“H5 正常，鸿蒙一片空白”的绝望感。别急，你提到的“只有一个 HBuilder logo”和“包名是 io.dcloud”都是非常典型的首次运行配置遗漏导致的问题。

下面我帮你逐一拆解，跟着步骤走，问题应该就能解决。

问题一：包名不对，显示的是 io.dcloud

你生成的鸿蒙包还是 io.dcloud，这说明你没有配置自己的包名，或者配置没生效。

需要明确一点：鸿蒙平台的配置，现在不是全部在 manifest.json 里直接改了。 你需要遵循以下步骤：

1. 生成专属配置文件：
   在你的 uni-app 项目根目录下，找到或新建一个 harmony-configs 文件夹。如果首次运行鸿蒙没有自动生成，你可以手动创建。

2. 放置并修改配置文件：
   鸿蒙的包名、应用名、签名等信息需要在这个目录下的特定文件中修改。你需要参考官方文档中关于“鸿蒙应用配置文件”的详细指南，找到正确的文件（如 app.json5 和 build-profile.json5）并按规范填写你的包名（例如 com.yourcompany.yourapp）。

3. 关键操作：清空缓存重试
   修改配置文件后，必须在 HBuilderX 运行选择时，勾选“清空缓存”选项，然后再次运行。这能确保你的新配置完全替代旧的默认配置。

如果对以上步骤的具体操作感到困惑，可以查阅官方的配置指南：
鸿蒙运行和发行 - 更多配置指南

问题二：应用启动后白屏，只有 HBuilder 的 Logo

这几乎可以确定是代码运行时有报错，导致页面渲染失败，只留下了启动图（即 HBuilder 的 Logo）。

通用排查思路（这部分是标准的开发调试知识）：

1. 通过日志定位错误：
   这是最关键的一步。你需要打开日志面板，查看具体的 JavaScript 错误信息。

   • HBuilderX 方式：在 HBuilderX 中运行到鸿蒙设备后，底部的控制台会输出日志。注意观察是否有红色的错误信息。
   • DevEco Studio 方式：这是官方更推荐的方式。用 DevEco Studio 打开 unpackage/dist/dev/app-harmony 目录下的鸿蒙工程。在 DevEco Studio 的 Log 面板中筛选你的应用，能看到更底层的崩溃和异常日志。

2. 常见导致白屏的代码原因：

   • 使用了不支持的 API：鸿蒙平台不支持 plus API。请检查你的代码，特别是 #ifdef APP-PLUS 条件编译块里的内容，确保鸿蒙端不会执行到。
   • 第三方库不兼容：检查你引入的 npm 包或 uni_modules 插件是否使用了鸿蒙不支持的语法或 API。可以尝试在一个全新的 Vue3 空白项目中运行，如果正常，再逐步引入你的业务代码和依赖，定位是哪个部分出了问题。
   • ES6+ 语法兼容性：鸿蒙的 JS 虚拟机可能对某些非常新的或非标准的语法支持不佳。可以检查报错日志，看是否指向某个具体的 JS 文件。
   • 页面路径或组件引入错误：检查 pages.json 中配置的首页路径是否正确，确保页面文件存在且能正常加载。

版本确认

你使用的 HBuilderX 5.0.7 正式版，对于开发 uni-app 的鸿蒙应用是完全支持的。它要求项目必须是 Vue3 版本，这一点你已经满足了，所以版本不是问题。

总结一下，你的解决路径是：

1. 配置包名：在 harmony-configs 目录下正确配置你的包名，并清空缓存后重试。
2. 排查白屏：使用 DevEco Studio 或 HBuilderX 控制台查看详细的错误日志，根据报错信息去排查代码中不兼容的 API、插件或语法。

如果按以上步骤排查后，依然无法解决，建议你带着完整的错误日志，去 ask社区 发帖求助，并提供你的复现工程，这样官方技术人员能更准确地帮你定位问题。

2026-06-03 19:30:25.053 [WARNING:] [PluginHost] copyFileByExt [Error: ENOENT: no such file or directory, lstat 'E:\xwork\aicar-uniapp\dist\dev.app-harmony\uni_modules\index.generated.ets'] {
errno: -4058,
code: 'ENOENT',
syscall: 'lstat',
path: 'E:\xwork\aicar-uniapp\dist\dev\.app-harmony\uni_modules\index.generated.ets'
}

2026-06-03 19:30:25.054 [WARNING:] [PluginHost] [Error: ENOENT: no such file or directory, scandir 'E:\xwork\aicar-uniapp\dist\dev.app-harmony\uni_modules'] {
errno: -4058,
code: 'ENOENT',
syscall: 'scandir',
path: 'E:\xwork\aicar-uniapp\dist\dev\.app-harmony\uni_modules'
} 一直报这个错那里配置问题吗？卡在19:30:22.473 ​[harmony-sync] skipped:​ ​harmony-project-missing​ ​​
19:30:22.481 开始构建鸿蒙工程 ...