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 会编译错误，因为不能传递被内联的 lambda
    func()
}

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 变大，方法数上升。

调试困难

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