T.apply->Unit):T{
block
return this
}
-
接收者
T
-
Lambda 类型带接收者
T.->Unit
-
返回值始终是 原对象本身这使得它非常适合链式调用。
kotlin
data class User(
var name:String="",var age:Int=0,var city:String=""
)
普通写法 vs apply
普通写法
kotlin
fun main{
val user=User
user.name="Tom"
user.age=28
user.city="上海"
println
}
使用 apply
kotlin
fun main{
val user=User.apply{
name="Tom"
age=28
city="上海"
}
println
}
输出
User
块内部可以直接访问属性。等价写法:
kotlin
val user=User.apply{
this.name="Tom"
this.age=28
}
apply 的返回值永远是原对象
即使 Lambda 最终一行是表达式，也不会影响返回值。kotlin
val result=User.apply{
name="Tom"
age=28
"最终一行字符串"
}
println // 输出仍然是 User 实例，而不是字符串
kotlin
data class Product(
var name:String="",var price:Double=0.0。var enabled:Boolean=true
)
fun main{
val product=Product
.apply{
name="Kotlin 入门课程"
price=99.9
}
.apply{
enabled=price>0 // 基于前一步计算结果
}
println
}
输出
Product
多个 apply 可以自由串联，但若同阶段属性较多，建议一次性放进同一个块以保持清晰。
配合 also 做日志或副作用
kotlin
data class Order(
var id:String="",var amount:Double=0.0,var status:String="CREATED"
)
fun main{
val order＝Order
.apply{
id="A001"
amount＝199.9
status＝"PAID"
}
.also{ println }
println
}
输出示例
订单已创建 → A001。金额=199.9
Order
kotlin
// List 示例
val languages＝mutableListOf.apply{
add
add
add
}
println //
// Map 示例
val scores＝mutableMapOf.apply{
put
put
put
}
println // {Kubernetes…}
与可空对象配合使用 – 安全且简洁
kotlin
data class Profile(
var nickname:String=""。var email:String="",var verified:Boolean=false
)
fun loadProfile:Profile?=
if Profile else null
fun main{
val profile＝loadProfile?.apply{
nickname＝"Tom"
email＝""
verified=true
}
println // Profile
}
``
若loadProfile返回null`。整个链路自动短路，不会抛 NPE，也无需显式判空。
不适合使用 apply 的场景
-
需要获取 Lambda 最终一行结果 → 用
let 或 run。
-
对不可变类型做转换 → 如
"kotl in".ap pl y{ uppercase} 返回仍是原字符串。应改为 "kotl in".uppercase 或 .let{ it.uppercase }.
-
业务逻辑过于复杂 → 把复杂判断、网络请求等抽离成普通函数，以免块内膨胀。
-
深度嵌套时注意
this 指向 → 使用标签 或局部变量消除歧义。
嵌套 apply 与标签示例
kotlin
class Address{ var city="";var street="" }
class Customer{ var name="";var address＝Address }
fun main{
val customer＝Customer.apply customerBlock@{
name ="Tom"
address.apply{
city ="上海"
street="${} 的街道"
}
}
println // Tom 的街道
}
自定义
：条件化配置
kotlin
inline fun T.applyIf->Unit):T{
if{ apply }
return this
}
data class ApiOptions(
var enableCache:Boolean=false。var timeoutSeconds:Int=30,var retryTimes:Int=0 )
fun main{
val debug=true
val opts＝ApiOptions
.ap pl y{ timeoutSeconds＝60 }
.ap pl yIf{
enableCache=true
retryTimes＝3
}
println
}
``
自定义
保持了`fluent API 风格，又让条件判断更加直观。
一图看清四大作用域函数差异
| 函数 |
接收者 |
返回值 |
常见用途 |
apply |
this |
原对象本身 |
初始化 / 配置 |
also |
it |
原对象本身 |
日志 / 副作用 |
let |
it |
Lambda 最终一行结果 |
空安全转换 / 数据处理 |
run |
this |
Lambda 最终一行结果 |
在对象作用域内计算并返回结果 |
with ** |
this |
Lambda 最终一行结果 |
对已有实例集中调用多个成员方法 |
至于选择教程，需要“配置并继续使用同一实例” → 用 apply;按理说，想“记录或执行副作用” → 用 also;想“把实例转换为别的值” → 用 let;想“在实例内部算出并返回一个新值” → 用 run.
实战 Demo：建立请求体
kotlin
data class SearchRequest(
var keyword:String="",var pageIndex:Int=1。var pageSize:Int=20,var sortBy:String ="createdAt",var descending:Boolean=true )
fun buildSearchRequest:SearchRequest =
SearchRequest.ap pl y{
this.keyword ＝keyword?.trim，.ifEmpty{""}?: ""
pageIndex ＝page?:1
pageSize ＝20
sortBy ＝"createdAt"
descending ＝true
}
fun main{
val req＝buildSearchRequest
println
}
输出示例
SearchRequest
实战 Demo：订单创建
kotlin
data class OrderItem
data class CreateOrderCmd(
var userId:Long=-1L。var items:MutableList=mutableListOf,var totalAmount:Double=-1.0,var remark:String="" )
fun createOrderCmd:CreateOrderCmd =
CreateOrderCmd.ap pl y{
this.userId =userId
this.items.addAll
totalAmount =item.sumOf{ it.qty*it.price }
this.remark ＝remark?.trim，:""
}
fun main{
val cmd=createOrderCmd,OrderItem)。" 快速发货 ")
println
}
输出示例
CreateOrderCmd
实战 Demo：简单 DSL Builder
kotlin
class DialogConfig{
var title:String="";var message:String="";var positiveText:String ="确定";var negativeText:String ="取消";按理说，var cancelable:Boolean=true;var onPositive:->Unit)?=null，}
fun dialog->Unit):DialogConfig =
DialogConfig.ap pl y
fun main{
val cfg＝dialog {
title ="删除确认"
message ="确定删除此记录吗？"
positiveText ="删除"
negativeText ="取消"
cancelable=false
onPositive ={println}
}
println
cfg.onPositive?.invoke
}
输出示例
删除确认 – 确定删除此记录吗？执行删除
常见注意事项 & 小技巧
1️⃣ 返回始终是原始实例
即使块内最终一行是表达式，也不会影响返回值。
2️⃣ 对不可变类型使用要慎重
不可变类（如 String。Int,BigDecimal) 的方法往往会返回新实例；此时
3️⃣ 保持块简洁
仅放置属性设置或轻量级配置；业务判断、IO、网络请求建议抽离为普通函数，以免块膨胀。按理说，
4️⃣ 嵌套时明确
使用标签 或临时变量避免混淆。例如上文 “Customer‑Address” 示例。
5️⃣ 与其它作用域函数组合使用
-
配置完毕后立即打印日志 →
.also{ …}
-
完成配置后进行校验并抛异常 →
.also{ it.validate }
-
想把配置好的实例转成另一种表示形式 →
.let{ transform }
🎯
-
-
使用
-
它总是返回原始对象，这一点决定了它最适合做初始化、属性赋值还有链式配置。
-
当你需要得到一个计算结果或进行数据转换时请切换到
或run\<\/em>。说起来，
-
注意嵌套时的
指向。并结合also\<\/em>实现日志/副作用分离。
-
自定义类似
只要你的目标是 “把一个对象快速组装好”，几乎每一次都可以考虑把传统的多行赋值
为一句优雅的
