DevEco Studio 无法新建项目，但可正常打开已有项目

DevEco Studio 无法新建项目，但可正常打开已有项目 核心现象：

可以正常启动 DevEco Studio，也能正常打开和编辑已有的鸿蒙项目，IDE 主界面、代码编辑、编译运行功能均无异常。

但在欢迎界面或 IDE 内点击「新建项目」按钮时，按钮完全无响应，无法弹出新建项目向导窗口，没有任何报错提示。

已尝试的解决方法（全部无效）：

  • 以管理员身份运行 IDE。
  • 修改 bin/idea.properties 添加 ide.browser.jcef.sandbox.enable=false。
  • 修改 bin/devecostudio64.exe.vmoptions 添加 ide.browser.jcef.gpu.disable=true。
  • 清理 IDE 缓存、删除 .devecostudio 配置目录后重启。
  • 完全卸载当前版本，重新安装旧版本 / 稳定版 DevEco Studio。
  • 关闭杀毒软件、Windows Defender 实时保护后重试。
  • 检查并确认 JBR 目录下的 JCEF 相关文件（chrome_elf.dll 等）均未被隔离或删除。

补充说明：

  • 问题出现在新建项目向导界面，然后进入旧项目也新建不了，推测与 JCEF 内嵌浏览器组件渲染异常有关。
  • 希望官方能提供针对性的修复方案或临时绕过方法。

3 回复

学习学习


DevEco Studio新建项目失败，通常因模板缓存异常或HarmonyOS SDK未完整安装。请清除IDE缓存（File > Invalidate Caches），并检查SDK Manager中API版本及工具链是否齐全。若仍无法新建，尝试以管理员身份运行IDE或关闭防火墙重试。

这是典型的 JCEF（Java Chromium Embedded Framework）渲染异常导致新项目向导界面无法创建。你已排查的手段很到位，剩下有效的临时绕过方案是：

直接使用命令行创建项目，完全绕过 UI 向导。

打开终端进入 DevEco Studio 的 bin 目录，执行：

devecostudio.exe --new-project <项目路径> --template <模板ID>

示例（创建空白 Ability 项目）：

devecostudio.exe --new-project D:\MyHarmonyApp --template ohos-empty-ability

模板 ID 可通过查看 DevEco Studio 安装目录 plugins\harmony\lib\templates\ 下的 template.json 获取，常用值为 ohos-empty-ability（空白 Ability）或 ohos-about-ability（单 Ability）。

执行后 IDE 会直接创建项目并在当前窗口打开，无需弹出向导窗口。此方法完全绕开 JCEF 组件，适用于你当前“向导 UI 无法渲染但引擎其他功能正常”的症状。

根本原因与持久解决： 该问题源于特定硬件/驱动环境下 JCEF 的 GPU 加速兼容性故障，你已添加的 ide.browser.jcef.gpu.disable=true 对向导窗口可能未覆盖。如需彻底解决，在 bin\devecostudio64.exe.vmoptions 中再追加一行：

-Djcef.commandLineArgs=--disable-gpu,--disable-gpu-compositing

保存后重启 IDE。若仍无效，暂时通过命令行创建项目即可正常开发。

回到顶部