别再混淆了！图解Kotlin五大作用域函数区别：let/run/with/apply/also对比表+记忆口诀

一图胜千言：Kotlin作用域函数终极指南与实战技巧

刚接触Kotlin时，面对let、run、with、apply、also这五个作用域函数，很多开发者都会感到困惑——它们看起来如此相似，却又各有不同。本文将带你深入理解这些函数的本质区别，通过独创的坐标系图解和记忆口诀，让你在10分钟内彻底掌握它们的核心用法。

1. 作用域函数本质解析

Kotlin标准库中的这五个作用域函数，本质上都是为了在特定作用域内对对象进行操作而设计的。它们的主要区别体现在两个方面：

1. 上下文对象引用方式：使用this还是it来引用对象
2. 返回值类型：返回上下文对象本身还是Lambda表达式结果

为了更直观地理解，我们可以将这些函数放在一个二维坐标系中：

这个表格清晰地展示了五个函数的核心区别。接下来，我们将深入分析每个函数的具体用法。

2. 函数详解与代码示例

2.1 let函数：空安全卫士

let是处理可空类型时的首选函数。它的特点是：

• 通过it引用对象
• 返回Lambda表达式的结果
• 非常适合在链式调用中处理可空值

val str: String? = "Hello" val length = str?.let { println("Value is $it") it.length // 返回字符串长度 }

常见使用场景：

• 对可空对象执行操作
• 将对象作为参数传递给其他函数
• 限制局部变量的作用域

2.2 run函数：多功能工具

run有两种形式：扩展函数和非扩展函数。我们主要讨论扩展函数形式：

• 通过this引用对象（可省略）
• 返回Lambda表达式的结果
• 适合需要同时访问对象成员和计算结果的场景

val result = "Kotlin".run { println("The string is $this") length // 返回字符串长度 }

与let的关键区别：

• run内部使用this引用对象，可以省略
• 更适合需要频繁访问对象成员的场景

2.3 with函数：非空对象的好帮手

with不是扩展函数，而是将对象作为参数接收：

• 通过this引用对象（可省略）
• 返回Lambda表达式的结果
• 适合对已知非空对象进行多步操作

val sb = StringBuilder() val result = with(sb) { append("Hello") append(" ") append("Kotlin") toString() // 返回构建的字符串 }

提示：with与run非常相似，主要区别在于with是普通函数而非扩展函数。

2.4 apply函数：对象初始化专家

apply专注于对象初始化：

• 通过this引用对象（可省略）
• 返回对象本身
• 适合构建对象并设置多个属性的场景

val person = Person().apply { name = "Alice" age = 25 department = "Engineering" }

典型应用：

• 对象创建和初始化
• Builder模式实现
• Android视图初始化

2.5 also函数：附加操作专家

also与apply类似，但使用it引用对象：

• 通过it引用对象
• 返回对象本身
• 适合需要执行附加操作（如日志记录）的场景

val list = mutableListOf<Int>().also { println("Initializing list") }.apply { add(1) add(2) add(3) }.also { println("List contents: $it") }

核心价值：

• 在不干扰主逻辑的情况下添加辅助操作
• 调试和日志记录
• 验证中间结果

3. 对比总结与记忆口诀

为了帮助大家快速记忆这些函数的区别，我总结了一个简单的口诀：

let空安全，it传参结果返 run改属性，this省略结果返 with非扩展，对象入参结果返 apply初始化，this省略自身返 also附加效，it传参自身返

这个口诀涵盖了五个函数的核心特点：

1. 引用方式：this还是it
2. 返回值：返回Lambda结果还是对象本身
3. 典型用途：空安全、属性修改、初始化等

4. 实战技巧与常见陷阱

4.1 如何选择合适的函数

选择作用域函数时，可以遵循以下决策流程：

1. 需要处理可空对象？ → 使用let
2. 需要返回对象本身？ → 选择apply或also
   • 需要记录或验证？ →also
   • 需要初始化？ →apply
3. 需要计算结果？ → 选择run或with
   • 已有对象实例？ →with
   • 需要链式调用？ →run

4.2 常见错误与修正

错误示例1：过度嵌套作用域函数

// 难以阅读的嵌套 user?.let { user -> user.orders?.let { orders -> orders.forEach { order -> order.items?.let { items -> // 处理items } } } }

修正方案：使用更扁平的结构

user?.orders?.forEach { order -> order.items?.also { items -> // 处理items } }

错误示例2：误用返回值

val person = Person().apply { name = "Bob" age = 30 }.let { // 这里返回的是let的结果，不是Person对象 it.toString() }

修正方案：根据需求选择函数

// 如果需要Person对象 val person = Person().apply { name = "Bob" age = 30 } // 如果需要字符串描述 val description = Person().run { name = "Bob" age = 30 toString() }

5. 高级应用场景

5.1 链式调用

作用域函数特别适合链式调用场景：

val result = request.create() .also { println("Request created: $it") } .apply { addHeader("Content-Type", "application/json") addHeader("Authorization", "Bearer $token") } .let { client.execute(it) } .takeIf { it.isSuccessful } ?.let { parseResponse(it) }

5.2 DSL构建

结合作用域函数可以创建优雅的DSL：

fun person(block: Person.() -> Unit) = Person().apply(block) val p = person { name = "Charlie" age = 28 address { street = "Main St" city = "New York" } }

5.3 配合协程使用

在协程中，作用域函数也能发挥重要作用：

suspend fun loadUserData(userId: String) = withContext(Dispatchers.IO) { api.getUser(userId) ?.also { log("User $userId loaded") } ?.let { user -> val details = async { api.getUserDetails(user.id) } val preferences = async { api.getUserPreferences(user.id) } UserData(user, details.await(), preferences.await()) } }

掌握Kotlin作用域函数需要一定的练习，但一旦熟练使用，它们能让你的代码更加简洁、表达力更强。建议从简单的场景开始尝试，逐步体会它们之间的细微差别。