本文系统讲解鸿蒙ArkUI状态管理V2，带你从入门到实战

大家好！今天要给大家分享的是鸿蒙开发中非常重要的状态管理。

我们在开发APP时，最常见的需求就是：数据变化时，UI要自动更新。比如：

• 用户点击按钮，计数+1，数字要自动变化

• 输入框输入文字，下面的列表要自动过滤

• 删除一条数据，列表要自动少一条

这些看似简单的功能，在传统开发中需要手动编写大量代码。但有了状态管理V2，一切变得非常简单！

1.1 生活中的例子

想象一下，你在餐厅点餐：

在这个过程中：

• 你 = 用户（操作UI）

• 点餐内容 = 状态（数据）

• 服务员 = 状态管理系统（负责同步）

• 做菜 = 业务逻辑处理

服务员（状态管理）把你的需求告诉厨房（数据层），厨房做好了自动端给你（UI自动更新），你不需要跑去厨房看菜做好了没有。

1.2 技术上的定义

状态管理 = 数据 + UI同步机制
当数据变化时，UI自动更新，无需手动操作。

在鸿蒙中，状态管理是基于MVVM架构模式实现的。

2.1 什么是MVVM？

2.2 数据流向

核⼼优势：数据驱动UI，开发者只需关注数据变化，UI⾃动更新！ 

鸿蒙状态管理V2提供了⼀系列强⼤的装饰器：

4.1 什么是@Local?

@Local 用于管理组件内部的状态。被它装饰的变量变化时，UI会自动更新。

4.2 基本语法

4.3 简单示例：计数器


4.4 效果展示


4.5 进阶：待办事项完成状态

5.1 什么是@Param？ 

@Param 让⼦组件可以接收⽗组件传⼊的数据。实现⽗→⼦的单向数据流。 

5.2 基本语法

5.3 示例：任务列表


5.4 数据流向

6.1 什么是@Event？ 

@Event ⽤于⼦组件向⽗组件输出事件/通知。实现⼦→⽗的单向通信。

6.2 基本语法

6.3 示例：删除任务



6.4 @Param + @Event 双向通信

学会这两个装饰器，你就可以实现⽗⼦组件的完美通信！

7.1 什么是@ObservedV2？ 

当需要管理对象数据时，普通装饰器可能不够⽤。@ObservedV2 让对象的属性变化可以被追踪。 

7.2 什么是@Trace？

@Trace 精确指定哪些属性需要追踪变化。只追踪被装饰的属性，优化性能。

7.3 基本语法

7.4 示例：任务对象

7.5 ⼯作原理

8.1 什么是Repeat？

Repeat 是鸿蒙提供的⾼效列表渲染组件，特别适合渲染⼤量数据。

8.2 两种模式

8.3 基本语法


8.4 示例：任务列表

9.1 存储⼯具对⽐

9.2 AppStorageV2：全局共享

9.3 PersistenceV2：持久化存储

9.4 完整示例：⽤户登录状态

让我们综合运⽤所有知识，实现⼀个完整的待办事项应⽤！

完整代码

功能特点

✅ 添加任务

✅ 删除任务

✅ 标记完成状态

✅ 数据持久化（关闭APP不丢失）

✅  @ObservedV2 + @Trace 精确追踪

✅  @Param + @Event ⽗⼦通信 

11.1 知识体系回顾

11.2 选择指南

11.3 学习路径

恭喜你！已经掌握了鸿蒙状态管理V2的核⼼知识！

状态管理是鸿蒙开发的基础，也是进阶的必经之路。掌握这些知识点后，你就可以轻松实现各种交 互逻辑，开发出流畅的APP了。 如果觉得⽂章对你有帮助，欢迎点赞收藏！

有问题也可以在评论区留⾔讨论~

本文作者：誉天HarmonyOS资深讲师——王琦老师