智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
多设备场景
应用质量
应用框架开发
系统开发
媒体开发
图形开发
应用服务开发
DevEco Studio
DevEco Testing
AI功能开发
问题现象
场景一：嵌套对象或者对象数组的属性发生改变时，如何实现UI刷新？
场景二：@ObjectLink修改嵌套对象属性后List不刷新。
背景知识
ArkUI中@Link装饰器是用于父子组件中的变量双向同步的。子组件通过@Link接收父组件传递的状态变量，当父组件/子组件任意一方发生改变时都会引起另一个同步变化。当装饰的是基本数据类型或者简单对象这类能直接被ArkUI框架观察到的就能触发页面实时渲染。对于复杂对象只能同步值的变化，无法触发UI渲染刷新。
@Observed装饰器和@ObjectLink装饰器用于实现嵌套对象或数组的双向数据同步。@ObjectLink接收的变量必须是@Observed装饰的类的实例，@ObjectLink仅能观察其直接绑定的对象属性变化，无法自动穿透到更深层的嵌套对象属性。
解决方案
场景一：
@Link装饰器只监听对象本身的地址以及第一层属性的地址变化。当装饰的对象为复杂类型，如对象数组时，其属性的变化不会让UI刷新。可以通过浅拷贝覆盖原来的值达到刷新UI的效果，但会导致不必要的渲染，不建议使用。
对于复杂对象的监听可以使用@Observed装饰器和@ObjectLink装饰器、@ObservedV2装饰器和@Trace装饰器、@Monitor装饰器，能观察到对象内部的其他对象发生改变，以实现刷新UI的功能。
场景二：
@ObjectLink修改嵌套对象属性后List不刷新，通常由以下几种情况导致：
- 嵌套对象的类未加@Observed装饰器。@ObjectLink接收的变量必须是@Observed装饰的类的实例，否则框架会打印error日志，属性变化不会被观测到，UI不会更新。
- 多级嵌套时，每一层的类都需要加@Observed，且每一层都需要抽离成独立子组件并用@ObjectLink绑定。@ObjectLink仅能观察其直接绑定的对象属性变化，无法自动穿透到更深层的嵌套对象属性。
- ForEach的keyGenerator返回值未变化。当修改数组中对象的属性时，如果key没有变化，ForEach不会重建子组件，@ObjectLink仍然指向旧的对象引用，导致@State与@ObjectLink断链。
- 嵌套对象未通过new实例化，而是直接赋值对象字面量。没有new创建的过程，无法激活@Observed的代理监听。
更多定位方法可参考状态变量改变不触发组件刷新问题常用定位方法。
相关推荐
华为开发者联盟 版权所有 ©2026
在 FAQ 中进行搜索
请输入您想要搜索的关键词