装完DevEco Studio,点新建项目没反应、运行就报错?别搜那些过时教程了,这篇是2026年最新版实测能用的步骤,我把踩过的坑都列出来,照着走半小时就能把第一个鸿蒙应用跑起来。
先选对版本,别下错了
现在官网有两套版本号:26.x和6.x,26是对齐API26的新版本,给新项目用;6.x是维护老项目的,两套工程不互通。新手直接下26.0.0 Release版就行,别碰Beta。
电脑配置至少8G内存,推荐16G,硬盘留100G空间,模拟器很吃内存,8G跑起来会很卡。
安装注意两个点
第一,安装路径必须全英文,不能有中文和空格,不然后面命令行运行会报路径错误。第二,Node.js让IDE自己装,别用你电脑里之前装的版本,版本不兼容会直接导致新建项目失败。
第一次启动选「不导入设置」,干净启动最不容易出问题。
新建项目没反应?这么解决
很多人点完Create Project没反应,这是JCEF组件被杀毒软件拦了,先关杀毒软件重启IDE。还不行就打开Help->Find Action搜Registry,勾上jcef.gpu.disable,重启就好。
模板选Empty Ability,语言ArkTS,设备只勾Phone,项目名也别用中文,点Finish等同步完。
三种运行方式怎么选
预览器最快,改完代码立刻看效果,但不是完整编译,部分API不支持;模拟器功能全,但第一次启动要下镜像,比较占内存,而且有些系统服务不支持;真机效果最准,需要华为手机开USB调试。新手写界面用预览器,测功能优先真机。
最常见的三个报错
npm ssl错误:终端执行npm config set strict-ssl false重启即可;找不到启动配置:点File->Sync and Refresh Project重新同步;预览器白屏:大概率是你开了全屏设置,这是预览器已知问题,换模拟器就好。
你第一次装DevEco的时候遇到过什么奇怪的报错?评论区聊聊,我帮你看看是什么问题。