HarmonyOS5鸿蒙开发常用装饰器一、UI 组件装饰器 @Component 标记 struct 为

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

@Provide 和 @Consume
实现祖先与后代组件的双向同步，无需逐层传递参数

// 祖先组件
@Provide('theme') theme: string = 'dark';

// 后代组件
@Consume('theme') theme: string;

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

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

@Watch

监听状态变量变化，触发回调逻辑

@State @Watch('onCountChange') count: number = 0;
onCountChange() { ... }

@Track
- 标记类对象的属性，仅当该属性变化时触发 UI 更新（优化性能）
```
class User {
  @Track name: string; // 仅 name 变化时更新 UI
}
```

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

HarmonyOS5鸿蒙开发常用装饰器