Kotlin 内联函数

Kotlin 的 内联函数（inline function） 是一种优化手段，它允许在编译时将函数的代码“展开”到调用处，从而避免函数调用的开销，尤其适用于 高阶函数（接受函数作为参数） 的场景。

什么是内联函数

正常函数调用会产生函数对象、栈帧和跳转指令，但内联函数会在编译时将函数代码插入到调用点，避免这些开销。

inline fun doSomething(block: () -> Unit) {println("Before")block()println("After")
}fun main() {doSomething {println("Hello")}
}

编译后大致等价于：

fun main() {println("Before")println("Hello")println("After")
}

函数体会“复制粘贴”到调用点。

什么时候使用 inline

Kotlin 中高阶函数（比如 let、run、with、apply）频繁使用内联，避免函数对象的创建（block: () -> Unit 不会生成 Function 对象），避免 lambda 的闭包捕获、堆分配和 GC 开销。普通业务函数不推荐使用内联，会导致代码膨胀。

inline 的工作原理

内联函数不是运行时特性，而是编译器替换机制。inline fun foo(block: () -> Unit) 编译器看到后就会展开 block() 的实现到调用点。如果有多个调用点，会展开多次（可能造成代码膨胀）。

使用 return@label可以局部返回：

inline fun doSomething(block: () -> Unit) {block()
}fun main() {doSomething {println("Inside block")return@doSomething // 局部返回，不影响 main}println("After")
}

如果不加 inline 会怎么样，编译器会生成 Function 实例（Function0），lambda 体被封装为对象，可能造成性能下降，尤其是在 Android 中。

fun doSomething(block: () -> Unit) {block()
}

noinline 与 crossinline

noinline

默认情况下，所有函数参数都会被内联。但你可以用 noinline 排除部分参数：

inline fun test(block1: () -> Unit, noinline block2: () -> Unit) {block1()  // 被内联block2()  // 作为函数对象
}

noinline 主要用于函数参数需要作为对象传递，以及不能内联的上下文（如存储到变量）。

inline fun doOps(inlineBlock: () -> Unit,noinline logging: () -> Unit  // 这里阻止了 logging 被内联
) {inlineBlock()   // 内联val func = logging  // 如果不加 noinline 会编译错误，因为不能传递被内联的 lambdafunc()
}

crossinline

禁止 lambda 用 return 做“非局部返回”。默认情况下，内联 lambda 可以直接 return，但有风险。

inline fun higherOrder(block: () -> Unit) {println("Before")block()println("After") // 如果 block 里直接 return，这行永远不会执行
}fun test() {higherOrder {return  // 这是“非局部返回”：会从 test() 函数直接返回}
}

要禁止这种“跳出上层函数”的行为，加 crossinline：

inline fun higherOrder(crossinline block: () -> Unit) {println("Before")block()println("After") // 如果 block 里直接 return，这行永远不会执行
}fun test() {higherOrder {return  // 现在 block() 里面不能写 return 了,这里会报错，但是依然可以写 return@higherOrder}
}

注意事项与风险

代码膨胀

inline fun heavy(block: () -> Unit) { ... }repeat(1000) {heavy { ... } // 编译后生成 1000 份代码
}

函数体复杂，调用频繁时，会导致APK 变大，方法数上升。

调试困难

内联函数展开后，调试栈信息会变得混乱，调试时跳转不准。