一、 ——为什么我的示例代码总是看不懂？

痛点：刚接触 HarmonyOS 开发的朋友往往面对 IDE 自动生成的示例代码感到眼花缭乱，不知道哪些是必需的、哪些可以删掉。

别担心，最好的学习方法就是动手实践。本篇将手把手教你从零删除示例代码，编写属于自己的第一个鸿蒙程序。

二、动手编写：Hello HarmonyOS

痛点：很多新手在创建项目后不知道该从哪个文件入手，更不知道如何快速预览效果。

1. 打开 DevEco Studio新建一个 HarmonyOS 项目。其实，
2. 项目创建完成后在 src/main/ets/pages 目录下找到默认生成的 Index.ets 文件。
3. 将文件内容全部删除。粘贴以下代码：

@Entry
@Component
struct Index {
build {
Text
}
}

保存后点击右上角的 Previewer 按钮或连接真机运行，你将看到屏幕上显示“你好鸿蒙”。恭喜，你已经成功运行了第一个鸿蒙程序！

三、代码解析——每一行都在干什么？

痛点：即使代码只有几行。新手仍常常不明白每个关键字和装饰器的意义，导致后续 时踩坑。

@Entry 装饰器

@Entry 用于. 程序会把带有该装饰器的组件作为启动页，只能出现一次。

@Component 装饰器

@Component 声明一个可复用的 UI 组件，相当于把下面的 struct 当作积木块来使用。

struct 关键字

struct 是 ArkTS 中定义自定义组件结构体的关键字，它包含组件状态、属性还有渲染逻辑。

Name

Name 是组件的标识符。你可以随意命名，例如 HelloPage/MainScreen,并在其他地方引用它。不过，

build 方法

build 是组件渲染函数。所有想要展示在页面上的 UI 都必须写在这里它相当于 React/Vue 的 render 函数。

The Text 组件

四、与接下来建议——别再卡在“看不懂示例”上了！

• #1 已经成功运行第一个页面："你好鸿蒙"
• #2 理解了主要概念：@Entry,@Component。,build,Text
• #3 接下来可以尝试：
• - 修改 Text 内容，观察实时预览变化；其实，
• - 添加 Button、Column 等布局组件；
• - 将业务逻辑抽离到独立模块，实现状态管理；

使用者痛点回顾：

• - 看不懂自动生成的示例代码 → 这篇文章提供逐行解释；
• - 不知道从哪儿开始动手 → 明确指向 Index.ets 并给出完整代码；
• - 难以预览和调试 → 推荐使用 Previewer 与真机双模式；
• - 担心概念混淆 → 用表格/列表形式拆解关键装饰器和关键字；
\end{ul}