HBuilderX 5.24 CLI 工程鸿蒙"生成本地打包App资源"报"node_modules缺少编译器模块"

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

你好，这个报错在知识库中有高度匹配的案例，先说结论，再给排查步骤。

这个报错大概率不是真的缺依赖，而是 HBuilderX 识别工程 vue 版本/编译器时误判

ask 社区有一条与你完全相同的报错记录（"node_modules缺少编译器模块，请执行npm install后重试"，HBuilderX 4.76、shell 启动正常但 HBuilderX 内无法编译），最终定位原因是：manifest.json 的 vueVersion 字段被改成了 "2"，改回 "3" 后立即恢复，该帖下多人确认遇到同样的坑。详见 【报Bug】node_modules缺少编译器模块，请执行npm install后重试。

结合你的情况（cli publish app-harmony 同样报错、uni build 本地编译正常），报错发生在 HBuilderX 侧的检查逻辑，而非依赖缺失。建议按以下顺序排查：

1. 检查 src/manifest.json 的 vueVersion
   CLI 工程的 manifest.json 在 src 目录下，确认其中为：

   "vueVersion": "3"  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
   鸿蒙平台仅支持 vue3，HBuilderX 一旦把工程识别成 vue2，就可能抛出这个误导性提示（知识库中也有升级后 vue3 项目被误判为 vue2、回退版本仍报错的类似案例，根因指向工程状态/缓存而非 HBuilderX 版本本身）。

2. 确认编译器核心依赖存在且版本统一
   vue3 工程被 HBuilderX 检查的编译器模块是 @dcloudio/vite-plugin-uni（官方人员在社区确认过该依赖缺失会导致工程无法被正常编译）。请在项目根目录执行 npm ls @dcloudio/vite-plugin-uni，确认它真实存在于 node_modules，且与 @dcloudio/uni-app-harmony 等其他 @dcloudio 包版本完全一致、没有多版本并存。版本对应关系可参考官方文档 cli 工程版本说明。

3. 用 HBuilderX 内置终端重装依赖
   删除 node_modules 和 lock 文件后，在 HBuilderX 内置终端执行 npm install。注意：外部终端或其他平台拷贝来的 node_modules 可能不被 HBuilderX 识别；另外已知 pnpm 安装的依赖在 HBuilderX 内运行会有异常，建议使用 npm。

4. 新建空白 vue3 工程对比验证
   用相同版本的 @dcloudio 依赖新建一个空白 vite + vue3 CLI 工程，执行同样的"发行 → App-Harmony-本地打包"菜单。如果新工程正常，逐项对比 manifest.json、package.json 差异，即可定位是哪个配置触发了误判。

关于你问的"还需要安装/配置哪个编译器组件"

知识库中暂未找到 HBuilderX 5.24 下 CLI 工程鸿蒙本地打包需要额外安装独立编译器组件的官方说明——该流程使用的就是项目 node_modules 里的 @dcloudio 编译器依赖，插件市场也没有对应组件，这一点与你的检索结论一致。同时，知识库中也确实没有覆盖此报错的官方指引文档。

如果完成以上排查（尤其是 vueVersion 确认为 "3" 后）问题依旧，建议携带最简复现工程到 DCloud issues 系统 提交 bug，或加入 uni-app鸿蒙化技术交流群 向官方值班人员反馈，这大概率是一个需要官方修复的检查逻辑缺陷。