一、
在鸿蒙应用开发中，@Link 是实现父子组件双向数据同步的关键装饰器。很多开发者在实际项目里会遇到以下痛点：
-
数据不一致：父组件修改状态后子组件未及时更新，或子组件修改后父组件仍保持旧值。
-
回调冗余：为实现双向同步。需要自行编写大量回调函数、事件分发，代码臃肿且易出错。
-
状态管理混乱：跨层级传递的数据缺乏统一规范，导致难以追踪和调试。
@Link 正是为了解决这些痛点而生。它让父子之间的状态天然保持同步，无需额外的回调或手动触发刷新。
@Link 装饰器：父子双向同步
主要规则
-
同步类型：双向同步
-
支持装饰的类型：
Object。class,string,number,boolean,enum,Date还有这些类型的数组。
-
初始化要求：禁止在子组件内部本地初始化，必须通过父组件传入。
-
不支持：
Function
示例代码——最基础的数值和布尔双向绑定
@Entry
@Componentstruct ParentComponent {
@State count: number = 0;@State selected: boolean = false;build {
Column {
Text;Text，Button.onClick => this.count++);
Divider，Text.fontWeight;
LinkChild，}
.width
.padding;}}
@Componentstruct LinkChild {
@Link count: number;@Link selected: boolean;build {
Column {
Row {
Text;Button.onClick => { this.count++;})，}
Row {
Text;Toggle
.onChange => { this.selected = isOn;})，}
}
.padding
.backgroundColor
.borderRadius;}
运行效果分析
-
初始状态：页面加载时父组件的
count=0,selected=false;子组件显示相同数值和关闭状态。
-
父组件操作：点击「父组件 +」后
{count} 自增；子组件文本立即更新，验证了「父 → 子」的自动传播。
-
子组件操作：
-
点击「子组件 +」后
{count} 在子组件内部自增，同步回父组件并刷新对应文本。
-
Toggle 开关切换时
{selected}`在子组件内部改变。同步至父组件，实现「子 → 父」实时更新。
-
关键
@Link*真正*解决了「数据不一致」和「回调冗余」两大痛点，实现了无缝双向同步。
使用要点
-
P1: 父组件通过$语法或直接传递变量对象给子组件的对应属性。
-
P2: 子组件内部对
@Link 变量的任何修改都会自动回流到父级，无需手动调用回调函数。
-
P3: 适用于表单编辑、开关切换等“子改动必须立刻反映到父”场景。
li>
-
‑‑P4: 若需处理更深层次嵌套对象。请结合
@Observed 或@ObjectLink使用，以获得细粒度监听能力。
二、进阶用法：对象类型与数组绑定
对象属性双向同步示例
@Entry
@Componentstruct Parent {
@State user: User = { name:'张三',age:25 };build {
Column {
Text;Child，}
}
}
@Componentstruct Child {
@Link user : User;其实，build{
Column{
Text;Button.onClick=>{ this.user.name='李四';})，}
}
}
interface User{
name的观点是，string;其实，age:number;}
-
初始状态 ： 父 & 子 同步显示 “张三,25 岁”。
-
子操作 ： 点击 “修改姓名” 后。子 component 中 的 user.name 改为 “李四”，父 component 文本立即更新。老实说，
-
主要结论 ： 对象类型一样支持全属性双向绑定。无需手动深拷贝或触发刷新。
三、注意事项与常用方法
-
避免循环依赖 ： 保持数据流单向或明确“双向”场景，防止多层级互相绑定导致无限渲染。
-
性能考量 ： 高频变化建议使用局部 State 或 @Observed 替代，以免整棵树重绘。
-
类型安全 ： 父传递的变量类型必须与子声明的 @Link 类型完全匹配，否则编译报错且不会产生绑定。
-
替代方案 ： 单向只读场景首选 @Prop；跨多层共享全局状态可使用 @Provide/@Consume 或全局 Store。
@Link 装饰器让鸿蒙开发者摆脱「手写回调」「状态不同步」的困扰。只需通过 $语法把 State 抛给子 component，就可以真正意义上的“双向同步”。掌握其主要规则、正确使用对象/数组绑定，并遵循上述常用方法。你将能够快速建立响应式、维护成本低的鸿蒙 UI 页面。
快去你的项目里尝试一下吧！不过，有疑问欢迎在 Github 提交 Issue 或 Pull Request。一起让 HarmonyOS 开发体验更顺畅！
