鸿蒙原生应用开发环境搭建：从零创建并运行第一个项目

本文详细介绍了HarmonyOS应用开发的完整流程，适合初学者快速入门。主要内容包括：环境准备：推荐使用Windows 10/11系统，16GB内存，并安装最新版DevEco Studio开发工具。 SDK配置：首次启动需下载必要的SDK组件，包括核心SDK、Node.js和模拟器环境。模拟器创建：通过设备管理器可创建多种类型的模拟器，如手机、平板等，用于应用调试。项目创建与运行：从新建项目

木子.1234

328人浏览 · 2026-05-31 14:58:00

木子.1234 · 2026-05-31 14:58:00 发布

一、前言

HarmonyOS（鸿蒙操作系统）是华为面向全场景智能设备的分布式操作系统，支持"一次开发、多端部署"，是当前移动开发领域的热门技术。本文将手把手带你完成DevEco Studio安装、SDK配置、模拟器创建，以及第一个HarmonyOS项目的构建与运行。

二、环境准备与安装DevEco Studio

2.1 开发环境要求

配置项	最低要求	推荐配置
操作系统	Windows 10/11（64位）	Windows 11
内存	8GB	16GB 及以上
硬盘	40GB 可用空间	SSD

💡 流畅运行模拟器建议内存16GB以上。

2.2 下载并安装DevEco Studio

DevEco Studio是华为官方提供的HarmonyOS应用开发IDE，基于IntelliJ IDEA定制，内置鸿蒙开发所需全部工具链。

下载地址： https://developer.huawei.com/consumer/cn/deveco/studio/

在这里插入图片描述

图1-1 DevEco Studio官方下载页面

下载完成后双击运行安装包，进入安装向导：

在这里插入图片描述

图2-1 安装向导启动界面

在安装选项中，将路径修改到非系统盘（如D:\DevEcoStudio），其余保持默认，点击 “Install” 等待完成（约5-10分钟）。

在这里插入图片描述

图2-2 安装路径和组件选择

三、首次启动与SDK配置

3.1 启动DevEco Studio

首次启动后，会出现欢迎界面，IDE会自动检测本地是否已安装HarmonyOS SDK。

在这里插入图片描述

图3-1 首次启动欢迎界面

3.2 配置SDK

本地无SDK时会弹出配置窗口，需要下载必要的SDK组件：

在这里插入图片描述

图3-2 SDK组件选择

建议勾选以下组件：

组件	说明
HarmonyOS SDK	核心SDK，含系统API
Node.js	构建前端资源（必装）
HarmonyOS Emulator	模拟器运行环境（必装）

⚠️ 中国大陆用户建议使用华为镜像源，下载速度更快。

点击 “Next” 开始下载，通常需要10-30分钟。

在这里插入图片描述

图3-3 SDK下载安装进度

💡 如下载中断，可通过 Tools > SDK Manager 重新进入下载页面。

四、模拟器配置

4.1 打开设备管理器

在菜单栏选择 Tools > Device Manager，或点击工具栏📱图标。

在这里插入图片描述

图4-1 设备管理器入口

4.2 新建模拟器

切换到"Phone"标签页，点击 + New Emulator。

在这里插入图片描述

图4-2 新建模拟器入口

4.3 选择设备模板

DevEco Studio提供了多种预设设备模板（手机、平板、智慧屏、智能穿戴等）。选择目标设备模板，点击"Next"。

在这里插入图片描述

图4-3 选择设备模板

设备类型	推荐场景
Huawei Phone	手机应用（新手推荐）
Huawei Tablet	平板应用
Huawei TV	智慧屏应用

输入显示名称后点击 “Create”，等待模拟器镜像创建完成。后续可随时从设备列表启动使用。

五、创建并运行第一个项目

5.1 新建项目

在欢迎页点击 Create HarmonyOS Project（或 File > New > New Project）。

在这里插入图片描述

图5-1 新建HarmonyOS项目

5.2 选择应用模型

HarmonyOS应用支持两种模型：

模型	说明	推荐度
Stage模型	新一代模型，支持多设备统一开发	⭐ 推荐
FA模型	传统模型	老项目迁移用

💡 新手建议选择Stage模型，这是官方主推的现代应用模型。

选择 Empty Ability（空白页面）模板，点击"Next"。

在这里插入图片描述

图5-2 选择Stage模型和空白模板

5.3 配置项目基本信息

在这里插入图片描述

图5-3 配置项目名称、包名、保存路径

配置项	说明	示例
Project Name	项目名称（英文）	Start
Bundle Name	应用包名（反向域名）	com.example.start
Save Location	保存路径	自定义

⚠️ Bundle Name上架后不可更改，请谨慎填写。

5.4 项目结构

项目创建后，DevEco Studio会自动生成完整的项目结构：

在这里插入图片描述

图5-4 Stage模型项目目录结构

图5-5 项目编译结果（Build Output），可在底部Build窗口查看编译详情，包括编译时间、资源打包情况等：
在这里插入图片描述

图5-5 项目编译输出结果

MyFirstApp/
├── AppScope/
│   └── app.json5            # 应用全局配置
├── entry/                   # 主模块
│   ├── src/main/
│   │   ├── ets/
│   │   │   ├── entryability/  # 应用生命周期入口
│   │   │   └── pages/         # 页面文件目录
│   │   ├── resources/       # 资源文件
│   │   └── module.json5      # 模块配置
├── hvigor/
└── build.gradle

关键文件：

entryability/EntryAbility.ets：应用主入口，管理生命周期
pages/index.ets：首页，编写UI的位置

5.5 编写第一行代码

打开 pages/index.ets，替换为以下代码：

// pages/index.ets
@Entry
@Component
struct Index {
  @State message: string = 'Hello HarmonyOS';

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .fontColor('#FF6600')
      }
      .width('100%')
    }
    .height('100%')
  }
}

📝 ArkTS是HarmonyOS的UI框架语言，基于TypeScript扩展，支持声明式UI，上手容易。

5.6 运行到模拟器

第一步：在设备管理器中选中模拟器，点击 ▶️ 启动（约等待1-2分钟）。

在这里插入图片描述

图6-1 模拟器启动

第二步：模拟器启动后，点击工具栏 ▶️ 运行按钮（或 Shift + F10），选择目标设备，点击"OK"。

第三步：DevEco Studio自动完成编译、打包、安装，模拟器中显示应用界面。

在这里插入图片描述

图6-3 第一个应用运行效果

🎉 恭喜！第一个HarmonyOS应用成功运行！

六、常见问题

问题	原因	解决方案
SDK下载失败	网络问题	配置华为镜像或使用代理
模拟器启动失败	CPU虚拟化未开启	BIOS中启用VT-x/AMD-V
编译报错	API版本不兼容	检查module.json5的apiVersion
Gradle同步失败	缓存损坏	删除.gradle和build目录后重新同步