前言工欲善其事必先利其器。在正式写代码之前我们先完成开发环境的搭建和项目的初始化创建。一、环境准备1.1 下载 DevEco StudioDevEco Studio 是 HarmonyOS 官方集成开发环境基于 IntelliJ IDEA 构建。项目说明下载地址华为开发者官网系统要求Windows 10/11 或 macOS 10.15内存建议8GB 以上推荐 16GB1.2 安装与配置安装 Node.jsDevEco Studio 内置了 Node.js也可自行安装 16.x 版本安装 SDK首次启动时按向导下载 HarmonyOS SDK配置模拟器Tools → Device Manager → 创建本地模拟器二、创建项目图文步骤2.1 新建工程File → New → Create Project2.2 选择模板进入模板选择页面按下图操作选项操作左侧标签选择应用默认已选中模板选择Empty Ability第一个已高亮选中说明该模板实现了基础的Hello World功能注意左侧有应用和元服务两个选项。应用需要安装通过桌面图标启动元服务免安装通过卡片或搜索启动。我们选应用。点击下一步进入配置页面。2.3 工程配置配置项截图值说明项目名称MyApplication可自定义包名com.example.myapplication应用唯一标识保存路径C:\Users\...\DevEcoStudioProjects\MyApplication代码存放位置Compatible SDK6.1.1(24)兼容 SDK 版本模块名称entry主模块名保持默认设备类型☑️ Phone勾选 Phone其他按需说明截图中的 SDK 版本6.1.1(24)是较新的 API 版本。如果你的环境显示的是5.0.0(12)或其他版本以实际安装的 SDK 为准即可。2.4 等待构建点击完成后ohpm 会自动下载依赖并构建项目。首次构建可能需要 3-5 分钟。三、配置模拟器3.1 打开设备管理器Tools → Device Manager或点击工具栏的设备图标。3.2 选择并创建模拟器设备类型名称版本(API)分辨率屏幕尺寸手机Pura 90HarmonyOS 6.1.1(24)1320×28566.8折叠屏Mate X7HarmonyOS 6.1.1(24)2210×24168.0平板MatePad Pro 13HarmonyOS 6.1.1(24)2880×192013.22in1MateBook ProHarmonyOS 6.1.1(24)3120×208014.2操作步骤点击新建模拟器按钮右下角选择设备类型推荐Pura 90手机下载系统镜像首次需要约 2-3GB启动模拟器提示所有设备都是 HarmonyOS 6.1.1(24) 版本与项目配置的 SDK 版本一致。模拟器文件默认存放在C:\Users\17246\AppData\Local\Huawei\Emulator\deployed。四、工程目录结构创建完成后项目结构如下MyApplication/ ├── AppScope/ # 应用级配置 │ └── app.json5 # 应用配置包名、图标等 ├── entry/ # 主模块Entry Module │ ├── src/ │ │ └── main/ │ │ ├── ets/ # ArkTS 源码目录 │ │ │ ├── entryability/ # Ability 生命周期管理 │ │ │ │ └── EntryAbility.ets │ │ │ └── pages/ # 页面目录 ⭐ │ │ │ └── Index.ets # 默认首页 │ │ ├── resources/ # 资源文件 │ │ │ ├── base/ │ │ │ │ ├── element/ # 颜色、字符串等常量 │ │ │ │ ├── media/ # 图片、音视频 │ │ │ │ └── profile/ # 页面路由配置 │ │ │ └── rawfile/ # 原始资源文件 │ │ └── module.json5 # 模块配置 │ └── build-profile.json5 # 构建配置 ├── hvigor/ # 构建系统配置 └── oh-package.json5 # 三方依赖管理核心文件说明文件作用Index.ets首页 UI 代码我们主要在这里写布局EntryAbility.ets应用入口控制页面生命周期module.json5模块配置注册页面路由app.json5应用全局配置五、运行 Hello World5.1 启动模拟器在设备管理器中点击启动▶️按钮。5.2 默认代码entry/src/main/ets/pages/Index.ets默认内容EntryComponentstruct Index{Statemessage:stringHello Worldbuild(){RelativeContainer(){Text(this.message).id(HelloWorld).fontSize(50).fontWeight(FontWeight.Bold).alignRules({center:{anchor:__container__,align:VerticalAlign.Center},middle:{anchor:__container__,align:HorizontalAlign.Center}})}.height(100%).width(100%)}}5.3 点击运行点击工具栏 ▶️Run按钮模拟器将显示居中的Hello World。六、创建新页面为 Day1 做准备在pages目录下新建IndexPages.ets右键 pages → New → ArkTS File → 输入 IndexPages然后在main_pages.json中注册路由// entry/src/main/resources/base/profile/main_pages.json{src:[pages/Index,pages/IndexPages]}七、常见问题问题解决方案模拟器启动失败检查 BIOS 是否开启 VT-x/AMD-V 虚拟化构建报错File → Invalidate Caches → 重启 IDESDK 下载慢设置华为镜像代理或更换网络真机调试需申请华为开发者账号并配置签名八、小结步骤完成内容✅ 环境搭建安装 DevEco Studio SDK✅ 项目创建Empty Ability Phone 设备✅ 模拟器配置创建 Pura 90 本地模拟器✅ 目录熟悉了解 ets/pages、resources 等核心目录✅ 运行验证模拟器成功显示 Hello World✅ 新页面准备创建 IndexPages.ets 并注册路由下节预告鸿蒙零基础实战教程Day1HarmonyOS ArkUI 入门实战—— 我们将在IndexPages.ets中编写第一个交互页面学习 Text、Button 组件和 promptAction 弹窗。建议今天先确保环境跑通明天直接写代码。如果遇到问题可以查阅 HarmonyOS 官方文档。