建议阅读 ArkUI 状态管理 文档。[@State](/user/State) 用于组件内部状态管理，[@Observed](/user/Observed) 用于标记可观察的类，配合 [@ObjectLink](/user/ObjectLink) 实现嵌套对象的深度监听。

详细说明

核心区别

使用 @State + @Observed + @ObjectLink 组合

说明：这是处理嵌套对象数组的标准方案。[@State](/user/State) 管理数组本身的变化（增删改），[@Observed](/user/Observed) 标记数据类为可观察，[@ObjectLink](/user/ObjectLink) 在子组件中绑定对象，实现属性级别的深度监听。

步骤：

1. 定义可观察的数据模型类

使用 [@Observed](/user/Observed) 装饰类，使其属性变化可被观察：

// Item.ets
[@Observed](/user/Observed)
export class Item {
  name: string = '';
  count: number = 0;
  
  constructor(name: string, count: number) {
    this.name = name;
    this.count = count;
  }
}

1. 在父组件中使用 @State 管理数组

// ParentComponent.ets
import { Item } from './Item'

@Entry
@Component
struct ParentComponent {
  [@State](/user/State) items: Item[] = [
    new Item('Item 1', 10),
    new Item('Item 2', 20),
    new Item('Item 3', 30)
  ]
  
  /**
   * 修改数组元素的属性
   */
  updateItem(index: number): void {
    // 直接修改对象属性，配合 [@ObjectLink](/user/ObjectLink) 可以触发UI更新
    this.items[index].count += 1
  }
  
  build() {
    Column() {
      ForEach(this.items, (item: Item, index: number) => {
        ItemComponent({ item: item })
      }, (item: Item) => item.name)
      
      Button('修改第一个项')
        .onClick(() => {
          this.updateItem(0)
        })
    }
  }
}

1. 在子组件中使用 @ObjectLink 绑定对象

// ItemComponent.ets
import { Item } from './Item'

@Component
struct ItemComponent {
  [@ObjectLink](/user/ObjectLink) item: Item
  
  /**
   * 修改对象属性
   */
  updateCount(): void {
    // 直接修改属性，会自动触发UI更新
    this.item.count += 1
  }
  
  build() {
    Row() {
      Text(this.item.name)
        .fontSize(16)
      Text(`数量: ${this.item.count}`)
        .fontSize(14)
      Button('+1')
        .onClick(() => {
          this.updateCount()
        })
    }
    .width('100%')
    .padding(10)
  }
}

使用状态管理 V2（@ObservedV2 + @Trace）

说明：如果项目使用状态管理 V2，可以使用 [@ObservedV2](/user/ObservedV2) 和 [@Trace](/user/Trace) 实现更强大的深度监听能力。这种方式支持对象属性的精确观察，性能更优。详细说明请参考：状态管理 V2。

步骤：

1. 定义 V2 可观察的数据模型类

// ItemV2.ets
import { ObservedV2, Trace } from '@kit.ArkUI'

[@ObservedV2](/user/ObservedV2)
export class ItemV2 {
  [@Trace](/user/Trace) name: string = '';
  [@Trace](/user/Trace) count: number = 0;
  
  constructor(name: string, count: number) {
    this.name = name;
    this.count = count;
  }
}

1. 在 V2 组件中使用 @Local 管理数组

// ParentComponentV2.ets
import { ItemV2 } from './ItemV2'

@Entry
@ComponentV2
struct ParentComponentV2 {
  [@Local](/user/Local) items: ItemV2[] = [
    new ItemV2('Item 1', 10),
    new ItemV2('Item 2', 20),
    new ItemV2('Item 3', 30)
  ]
  
  /**
   * 修改数组元素的属性
   */
  updateItem(index: number): void {
    // [@ObservedV2](/user/ObservedV2) + [@Trace](/user/Trace) 支持直接修改属性并触发UI更新
    this.items[index].count += 1
  }
  
  build() {
    Column() {
      ForEach(this.items, (item: ItemV2, index: number) => {
        ItemComponentV2({ item: item })
      }, (item: ItemV2) => item.name)
      
      Button('修改第一个项')
        .onClick(() => {
          this.updateItem(0)
        })
    }
  }
}

1. 在 V2 子组件中使用 @Param 接收对象

// ItemComponentV2.ets
import { ItemV2 } from './ItemV2'

@ComponentV2
struct ItemComponentV2 {
  [@Param](/user/Param) item: ItemV2 = new ItemV2('', 0)
  
  /**
   * 修改对象属性
   */
  updateCount(): void {
    // 直接修改属性，[@ObservedV2](/user/ObservedV2) + [@Trace](/user/Trace) 会自动触发UI更新
    this.item.count += 1
  }
  
  build() {
    Row() {
      Text(this.item.name)
        .fontSize(16)
      Text(`数量: ${this.item.count}`)
        .fontSize(14)
      Button('+1')
        .onClick(() => {
          this.updateCount()
        })
    }
    .width('100%')
    .padding(10)
  }
}

注意事项

• @State 的局限性：[@State](/user/State) 只能监听变量本身的赋值变化，无法监听对象内部属性的变化。直接修改 [@State](/user/State) 数组元素的属性不会触发 UI 更新
• @Observed 必须配合 @ObjectLink 使用：单独使用 [@Observed](/user/Observed) 不会自动触发 UI 更新，必须在子组件中使用 [@ObjectLink](/user/ObjectLink) 绑定对象
• V1 和 V2 不能混用：V1 组件中不能使用 V2 装饰器，V2 组件中不能使用 V1 装饰器。新项目推荐直接使用 V2
• 数组元素替换 vs 属性修改：如果使用 [@State](/user/State) 管理数组，直接修改数组元素的属性不会触发更新，需要配合 [@Observed](/user/Observed) + [@ObjectLink](/user/ObjectLink) 或使用 V2 的 [@ObservedV2](/user/ObservedV2) + [@Trace](/user/Trace)
• 性能考虑：V2 的状态管理性能更优，支持精确的属性级更新，避免不必要的 UI 刷新