@List是HarmonyOS ArkUI框架中用于构建高性能列表的核心组件，它专门针对大数据集进行了优化，支持垂直和水平滚动布局，能够高效渲染成百上千的列表项而不会影响性能。与常规的Column布局不同，@List采用按需渲染机制，只渲染当前可视区域内的列表项。
1. 基础语法结构
@List({ space?: number | string, initialIndex?: number, scroller?: Scroller })
build() {
List() {
// 列表项
ListItem() {
Text('Item 1')
}
ListItem() {
Text('Item 2')
}
}
.listDirection(Axis.Vertical) // 排列方向
}
2、简单示例
实现代码：
3、布局方向控制
List()
.listDirection(Axis.Vertical) // 垂直列表（默认）
// 或
.listDirection(Axis.Horizontal) // 水平列表
@List装饰器的核心优势：
极致性能：支持大数据集流畅滚动
丰富功能：内置刷新加载、分组、编辑等企业级功能
灵活定制：完全可定制的列表项和交互效果
开发高效：简洁API快速实现复杂列表需求
通过掌握@List组件，开发者可以轻松构建各种高性能列表界面，满足从简单展示到复杂交互的各种业务场景需求。