HarmonyOS5鸿蒙开发常用装饰器

@Component
- 标记 struct 为自定义组件，必须实现 build() 方法描述 UI 结构
- 示例：
  scss 复制代码
```
@Component
struct MyButton {
  build() {
    Button('Click')
  }
}
```
@Entry
- 声明页面入口组件，每个页面仅允许一个 @Entry 装饰的组件
- 常与 @Component 组合使用：
  less 复制代码
```
@Entry
@Component
struct HomePage { ... }
```
@Reusable
- 使组件具备复用能力，优化频繁创建/销毁场景的性能（如列表滑动、条件渲染）
- 限制：仅能在同一父组件下复用实例。

@State

组件内部私有状态变量，变化触发 UI 刷新
ini 复制代码
```
@State count: number = 0;
```
@Prop

单向同步父组件的参数，子组件不可修改
less 复制代码
```
@Prop title: string; // 父组件传递的只读数据
```
@Link

父子组件双向数据绑定，修改同步至父组件

@Provide 和 @Consume

实现祖先与后代组件的双向同步，无需逐层传递参数
less 复制代码
```
// 祖先组件
@Provide('theme') theme: string = 'dark';

// 后代组件
@Consume('theme') theme: string;
```
@Observed 和 @ObjectLink

用于嵌套对象或数组属性的双向同步 @Observed 装饰类，@ObjectLink 装饰子组件中接收该类的变量。

@LocalStorageProp / @LocalStorageLink

与页面级 LocalStorage 中的属性建立单向/双向同步
@StorageProp / @StorageLink

与全局 AppStorage 中的属性建立单向/双向同步

@Builder
- 封装可复用的 UI 描述块，支持引用状态变量（$$ 语法）
  scss 复制代码
```
@Builder customButton($$: { text: string }) {
  Button($$.text).width(100)
}
```
@BuilderParam
- 作为占位符，接收外部传入的 @Builder 方法
  less 复制代码
```
@BuilderParam action: () => void;
```
@Styles 和 @Extend
- @Styles：封装多条样式属性，支持全局或组件内复用
  scss 复制代码
```
@Styles fancy() {
  .width(200).backgroundColor(Color.Red)
}
```
- @Extend：扩展原生组件样式，支持参数传递
  less 复制代码
```
@Extend(Text) function textStyle(size: number) {
  .fontSize(size).fontColor('#333')
}
```
stateStyles
- 依据组件内部状态（如按下、禁用）动态切换样式

@Watch
- 监听状态变量变化，触发回调逻辑
  less 复制代码
```
@State @Watch('onCountChange') count: number = 0;
onCountChange() { ... }
```
@Track
- 标记类对象的属性，仅当该属性变化时触发 UI 更新（优化性能）
  kotlin 复制代码
```
class User {
  @Track name: string; // 仅 name 变化时更新 UI
}
```

更多实践案例可参考：HarmonyOS 开发文档 developer.huawei.com/consumer/cn... 。实际开发中需根据场景组合使用，例如 @State + @Watch 实现状态监听，@Provide + @Consume 替代深层参数传递。