HarmonyOS鸿蒙Next中新建项目进去后就这样了，没办法预览和运行，求大哥解答！

HarmonyOS鸿蒙Next中新建项目进去后就这样了，没办法预览和运行，求大哥解答！

Project sync failed.Basic functionality(e.g. editing, debugging) will not work properly！

重装了很多遍，昨天出现以后我就一直重装，下载的最新版本6.1.1，不知道哪来的问题，我是新手小白，第一次用鸿蒙开发软件，希望大哥帮忙！

图片

图片

图片

图片


更多关于HarmonyOS鸿蒙Next中新建项目进去后就这样了，没办法预览和运行，求大哥解答！的实战教程也可以访问 https://www.itying.com/category-93-b0.html

15 回复

您好，参考以下排查一下是否可以解决

  1. 确认是否是代理问题导致网络连接失败。一般来说，如果使用的是个人或家庭网络，是不需要配置代理信息的，部分企业网络受限的情况下，才需要配置代理信息。

开发环境问题可以参考官方文档：诊断开发环境。

代理配置可以参考：配置代理。

  1. 看下是否DevEco Studio缓存问题导致，通过如下步骤清除缓存：DevEco Studio -> File -> Invalidate caches。

  2. 重启ide，删除hvigor、oh_modules，重新 Sync是否可以

更多关于HarmonyOS鸿蒙Next中新建项目进去后就这样了，没办法预览和运行，求大哥解答！的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


  • DevEco Studio提供开箱即用的开发体验，将HarmonyOS SDK、Node.js、Hvigor、OHPM、模拟器平台等进行合一打包，简化DevEco Studio安装配置流程。
  • HarmonyOS SDK已嵌入DevEco Studio中，无需额外下载配置。HarmonyOS SDK可以在DevEco Studio安装位置下DevEco Studio\sdk目录中查看。

先用工具诊断下环境：

cke_5866.png

参考：DevEco Studio启动项目报错Project sync failed

找HarmonyOS工作还需要会Flutter的哦，有需要Flutter教程的可以学学大地老师的教程，很不错，B站免费学的哦：https://www.bilibili.com/video/BV1S4411E7LY/?p=17

开发者您好，建议排查：

  1. 退出所有杀毒软件，重新打开DevEco Studio，防止拦截构建程序。
  2. 更换项目目录，重新建项目。
  3. 退出所有杀毒软件，避免拦截安装程序，重新安装DevEco Studio。

电脑没有杀毒软件，重建项目也没用

彻底关闭DevEco Studio，重新启动试试。

从截图看，关键不是预览器本身，而是工程同步失败后依赖和索引没有建起来。已有回复提到先做环境诊断，我这边补一条更可执行的排查路径：

  1. 新建一个空白默认工程同步，如果也失败，优先看 DevEco 6.1.1 的代理/网络、安全软件拦截和安装目录权限；
  2. 如果只有当前工程失败，关闭 IDE 后删 .hvigor、oh_modules，重新 Sync；
  3. 工程路径尽量换成纯英文短路径，不放桌面同步盘。

还需要补充 Sync 日志里第一条 ERROR/Caused by、系统版本和工程路径。

“Project sync failed. Basic functionality (e.g. editing, debugging) will not work properly.” 表示项目同步（Sync）失败，IDE 无法完成工程解析、依赖下载安装、编译构建初始化等流程，因此预览、运行等所有功能都无法正常使用。

你可以试试以管理员身份运行 DevEco Studio，因为 DevEco Studio 自带 Node.js，首次启动时需要安装 pnpm 等依赖，如果当前 Windows 用户权限不足，npm 无法在系统目录下创建缓存文件，导致 pnpm 安装失败，进而 Sync 失败。

操作步骤：

  • 完全关闭 DevEco Studio
  • 右键点击 DevEco Studio 的桌面快捷方式或开始菜单项
  • 选择"以管理员身份运行"
  • 重新打开项目，等待 Sync 完成

如果是权限问题导致的，首次以管理员身份运行成功后，后续正常双击打开即可。

cke_116.png

我感觉你的问题符合场景三，清一下缓存然后重启软件或者重启下系统在试一下呢。

通过如下步骤清除缓存：DevEco Studio -> File -> Invalidate caches。

找HarmonyOS工作还需要会Flutter的哦，有需要Flutter教程的可以学学大地老师的教程，很不错，B站免费学的哦：https://www.bilibili.com/video/BV1S4411E7LY/?p=17

按照这个方式试一下 cke_122.png，

你装npm了吗

新建项目后无法预览和运行，常见原因：DevEco Studio未自动同步SDK、HarmonyOS SDK路径未配置、本地模拟器未创建或未启动、项目缺少签名配置。检查Project Structure中SDK版本是否匹配，确认模拟器或真机已连接且授权，同步Gradle后再试。若仍异常，删除.idea与build目录重建工程。

“Project sync failed” 表示项目同步失败，核心是 IDE 没能从远程仓库拉取到依赖。这不是重装能解决的，常见原因有两个：

  1. 网络问题：无法访问华为/OpenHarmony 的仓库，导致依赖下载超时或失败。
  2. HarmonyOS SDK 没有完整安装：DevEco Studio 的安装向导可能不含 SDK，需要在 Settings → SDK 里确认已经下载了对应的 HarmonyOS SDK 组件，并指定了正确的 SDK 路径。

可以按以下步骤排查：

  • 在 File → Sync and Refresh Project 手动再同步一次，看错误详情。
  • 打开 Help → Show Log，查看具体报错，如果是 “Connect timed out” 就是网络问题。
  • 如果有代理，检查代理配置是否生效；关闭防火墙或换个网络（如手机热点）再试。
  • 确认新建项目时选择的模板版本与本地 SDK 版本匹配。

你的截图里如果出现 “Failed to find” 或 “Could not resolve” 字样，基本就是依赖拉取失败，按网络问题处理即可。

回到顶部