Kotlin List 操作全面指南

在传统 Java 开发 List 相关的 API 中，有着样板代码冗长、缺乏链式调用、空安全等问题。

Kotlin 这门语言为 List 提供了丰富的扩展函数，这些函数大大简化了集合操作，解决了传统 Java 集合 API 中的许多痛点。

一、基础操作

1. 创建 List

Kotlin 复制代码

val list = listOf(1, 2, 3) // 不可变
val mutableList = mutableListOf(1, 2, 3) // 可变
val emptyList = emptyList<Int>() // 空列表

2. 访问元素

Kotlin 复制代码

val element = list[1]                 // index 访问
val elementOrNull = list.getOrNull(5) // index 访问元素(失败返回 null)

val first = list.first()            // 访问第一个元素
val firstOrNull= list.firstOrNull() // 访问第一个元素(失败返回 null)

val last = list.last()              // 访问最后一个元素
val lastOrNull= list.lastOrNull()   // 访问最后一个元素(失败返回 null)

二、转换操作

1. 映射转换

Kotlin 复制代码

val doubled = list.map { it * 2 } // [1,2,3] → [2,4,6]

在复杂的数据 bean list 中，使用 map 能快速提取某一个字段组成新的 list：

Kotlin 复制代码

class Person(val name: String, val age: Int)

val personList = mutableListOf<Person>().apply {
    add(Person("张三", 22))
    add(Person("李四", 28))
}
val nameList = personList.map { it.name } // ["张三", "李四"]
val ageList = personList.map { it.age }    // [22, 28]

2. 扁平化

Kotlin 复制代码

val nested = listOf(listOf(1, 2), listOf(3, 4))
val flat = nested.flatten() // [1,2,3,4]
val flatMapped = nested.flatMap { it.map { it * 2 } } // [2,4,6,8]

三、过滤操作

1. 基本过滤

Kotlin 复制代码

val list = listOf(1, 2, 3, 4, 5, 6, 7, 8)
val filterList = list.filter { it % 2 == 0 } // [2, 4, 6, 8]

在复杂的数据 bean list 中，使用 filter 能快速根据业务条件的字段组成新的 list：

Kotlin 复制代码

class Person(val name: String, val age: Int)

val personList = mutableListOf<Person>().apply {
    add(Person("张三", 22))
    add(Person("李四", 28))
    add(Person("王五", 31))
}
val filterList = personList.filter{ it.age > 25 } // [Person("李四", 28), Person("王五", 31)]

2. 去重

Kotlin 复制代码

val list = listOf(1, 2, 2, 3, 1)
val distinctList = list.distinct() // [1,2,3]

四、排序操作

1. 升/降序

Kotlin 复制代码

val list = listOf(3, 1, 4, 1, 5)
val sorted = list.sorted()               // [1, 1, 3, 4, 5]  (升序排列)
val descending = list.sortedDescending() // [5, 4, 3, 1, 1]  (降序排列)

在复杂的数据 bean list 中，使用 sortedBy/sortedByDescending 能快速根据字段进行排序组成新的 list：

Kotlin 复制代码

class Person(val name: String, val age: Int)

val personList = mutableListOf<Person>().apply {
    add(Person("张三", 22))
    add(Person("王五", 31))
    add(Person("李四", 28))
    add(Person("老六", 20))
}
val ascendingList = personList.sortedBy { it.age } // [Person("老六", 20), Person("张三", 22), Person("李四", 28), Person("王五", 31)]
val DescendingList = personList.sortedByDescending { it.age } // [Person("王五", 31), Person("李四", 28), Person("张三", 22), Person("老六", 20)]

2.反转顺序

Kotlin 复制代码

val list = listOf('a', 'b', 'c')
list.reversed() // ['c', 'b', 'a']

五、聚合操作

1. 求和/平均

Kotlin 复制代码

val list = listOf(1, 2, 3, 4)
val sum = list.sum()          // 10
val average = list.average()  // 2.5

在复杂的数据 bean list 中，使用 sumOf 能快速计算 list 中字段的总和

Kotlin 复制代码

class Product(val name: String, val price: Int)

val productList = mutableListOf<Product>().apply {
    add(Product("西红柿", 5))
    add(Product("香蕉", 7))
    add(Product("苹果", 3))
    add(Product("菠萝", 10))
}
val priceSum = list.sumOf { it.price } // 价格总和: 25

2. 最大/最小

Kotlin 复制代码

val list = listOf(1, 2, 3, 4)
val min = list.min() // 最小值: 1
val max = list.max() // 最大值: 4

3. 统计

Kotlin 复制代码

val list = listOf(1, 2, 3, 4)
val count = list.count { it >= 2 } // list中大于等于2的item数量: 3

六、查找操作

1. 查找元素

Kotlin 复制代码

val list = listOf(1, 2, 3, 4, 5, 6)
val find = list.find { it > 3 } // 查找第一个大于3的数(失败返回null)

在复杂的数据 bean list 中，使用 find 能快速寻找某个字段值对应的数据 bean：

Kotlin 复制代码

class Person(val name: String, val age: Int)

val personList = mutableListOf<Person>().apply {
    add(Person("张三", 22))
    add(Person("王五", 31))
    add(Person("李四", 28))
    add(Person("老六", 20))
}
val zhangsan = personList.find { it.name = "张三" } // 根据 name 查找 list 中的数据 bean

2. 条件检查

Kotlin 复制代码

val list = listOf(1, 2, 3, 4, 5, 6)
val any = list.any { it > 7 } // list 中是否 有元素 大于7
val all = list.all { it > 0 } // list 中是否 所有元素 大于0

七、集合操作

1. 合并

Kotlin 复制代码

val list1 = listOf(1, 2, 3, 4, 5, 6)
val list2 = listOf("a", "b")
val zip = list1.zip(list2)  // [(1, a), (2, b)]
val zipWithNext = list1.zipWithNext() // [(1, 2), (2, 3), (3, 4), (4, 5), (5, 6)]

2. 集合运算

Kotlin 复制代码

val list1 = listOf(1, 2, 3, 4, 5)
val list2 = listOf(5, 6, 7, 8, 9)
val union = list1 + list2              // 并集: [1, 2, 3, 4, 5, 5, 6, 7, 8, 9]
val intersect = list1.intersect(list2) // 交集: [5]
val subtract1 = list1.subtract(list2)  // 差集: [1, 2, 3, 4]
val subtract2 = list2.subtract(list1)  // 差集: [6, 7, 8, 9]

八、其他

1. 遍历

Kotlin 复制代码

list.forEach { println(it) }
list.forEachIndexed { index, value -> println("$index: $value") }

2. 随机元素

Kotlin 复制代码

val random = list.random()

3. 字符串连接

Kotlin 复制代码

val list = listOf(1, 2, 3, 4, 5)
val joinToString = list.joinToString(", ", "[", "]") // [1, 2, 3, 4, 5]