前言

对于第一次接触 HarmonyOS NEXT 的开发者来说，最大的难题往往不是写代码，而是环境配置。

很多人在安装过程中会遇到这些问题：

• DevEco Studio 下载速度慢
• SDK 下载失败
• 模拟器无法启动
• JDK 版本不兼容
• 创建项目后无法运行
• 真机调试识别不到设备

网上的大部分教程都比较零散，版本也已经过时。

因此，本文将基于 HarmonyOS NEXT 最新开发环境，带大家从零开始完成开发环境的搭建，并成功运行第一个鸿蒙应用。

本文适合以下人群：

• 零基础学习 HarmonyOS NEXT
• Android 开发者转鸿蒙
• 大学生课程设计、毕业设计
• 准备参加鸿蒙开发岗位面试

---

一、开发 HarmonyOS NEXT 需要准备什么？

在开始之前，我们先了解开发鸿蒙应用需要哪些工具。

工具	作用	是否必须
DevEco Studio	鸿蒙官方 IDE	✅
HarmonyOS SDK	开发 SDK	✅
模拟器	运行应用	推荐
真机	调试应用	推荐
华为开发者账号	下载组件、签名	推荐

其中最重要的是：

DevEco Studio + HarmonyOS SDK

---

二、安装 DevEco Studio

DevEco Studio 是 HarmonyOS 官方提供的集成开发环境，可以理解为鸿蒙版的 Android Studio。

它支持：

• ArkTS 开发
• ArkUI 可视化预览
• 模拟器管理
• 真机调试
• 性能分析
• 应用签名与打包

安装过程非常简单：

1. 下载最新版安装包。
2. 双击运行安装程序。
3. 选择安装目录（建议不要安装在中文路径）。
4. 等待安装完成。

安装完成后，首次启动会进入初始化配置界面。

---

三、首次启动需要配置什么？

第一次打开 DevEco Studio，会提示配置开发环境。

主要包括以下几个部分：

1. SDK

如果本地没有 HarmonyOS SDK，IDE 会提示下载。

建议直接选择最新稳定版本。

SDK 包括：

• ArkTS 编译器
• 系统 API
• 模拟器镜像
• 调试工具

下载完成后，IDE 会自动完成配置。

---

2. JDK

新版 DevEco Studio 已经内置 JDK。

因此一般不需要手动安装。

如果之前配置过 Java 环境，也可以在设置中切换。

---

3. Node.js

部分工具链依赖 Node.js。

通常 IDE 会自动检测。

如果没有安装，会提示下载。

---

四、创建第一个 HarmonyOS NEXT 项目

点击：

New Project

可以看到多个模板。

对于初学者，推荐选择：

Empty Ability

然后填写：

• Project Name
• Package Name
• Save Location

点击 Finish。

等待项目初始化完成。

---

五、认识项目目录结构

第一次打开项目，很多同学都会被目录吓到。

其实真正需要关注的只有几个目录。

entry
├── src
│   ├── main
│   │   ├── ets
│   │   │    ├── pages
│   │   │    ├── components
│   │   │    └── entryability
│   │   └── resources

pages

存放页面。

例如：

Index.ets
Login.ets
Home.ets

---

components

存放公共组件。

例如：

UserCard
GoodsItem
Banner

---

resources

资源目录。

包括：

图片
字符串
颜色
字体

---

entryability

应用入口。

类似 Android 的 MainActivity。

---

六、运行第一个鸿蒙程序

打开：

Index.ets

默认代码类似：

@Entry
@Component
struct Index {
  build() {
    Column() {
      Text("Hello HarmonyOS")
    }
  }
}

点击 IDE 上方的：

Run

第一次运行需要等待编译。

如果配置正常，很快就会看到：

Hello HarmonyOS

说明开发环境已经搭建成功。

---

七、模拟器无法启动怎么办？

这是新手最常见的问题。

常见原因如下：

1. 没有安装模拟器镜像

解决方法：

SDK Manager 中安装 Emulator。

---

2. BIOS 未开启虚拟化

需要进入 BIOS 开启：

Intel VT-x

或

AMD-V

否则模拟器无法启动。

---

3. 内存不足

建议：

至少预留：

8GB+

运行模拟器会更加流畅。

---

八、真机调试步骤

很多同学更喜欢使用手机调试。

操作流程：

第一步：

手机开启：

开发者模式

第二步：

开启：

USB 调试

第三步：

连接电脑。

IDE 会自动识别设备。

选择：

Run

即可安装应用。

相比模拟器：

真机：

• 更流畅
• 更接近真实运行环境
• 更适合调试性能问题

---

九、新手最容易踩的坑

坑一：项目路径包含中文

例如：

D:\桌面\鸿蒙项目

可能导致：

编译失败

建议：

D:\Code\HarmonyProject

---

坑二：SDK 下载失败

原因：

网络不稳定。

建议：

等待重试，不要频繁取消。

---

坑三：Node.js 未正确配置

表现：

Build Failed

建议：

检查 IDE 的 Node.js 配置路径。

---

坑四：模拟器黑屏

一般是：

• 显卡驱动问题
• 虚拟化未开启

重新创建模拟器通常可以解决。

---

十、开发环境搭建完成后，下一步学什么？

很多同学搭好环境后不知道该学什么。

建议按照下面的路线学习。

第一阶段：ArkTS 基础

• 变量
• 函数
• 类
• 接口
• 泛型

预计：3～5 天。

---

第二阶段：ArkUI 组件

重点掌握：

• Text
• Button
• Image
• TextInput
• Row
• Column
• List

预计：1 周。

---

第三阶段：状态管理

学习：

• @State
• @Prop
• @Link
• @Provide
• @Consume

预计：1 周。

---

第四阶段：项目实战

推荐项目：

• TodoList
• 登录页面
• 天气 App
• 新闻 App
• 电商首页

预计：2～3 周。

---

总结

开发 HarmonyOS NEXT 的第一步，就是搭建好开发环境。

整个过程并不复杂，但要注意：

• 使用最新版 DevEco Studio
• 保持 SDK 完整安装
• 项目路径不要包含中文
• 优先使用真机调试

完成这些之后，就可以正式开始 HarmonyOS NEXT 的学习之旅。