第4章 内联函数优化：inline 关键字作用、noinline / crossinline 使用场景

4.1 inline 关键字原理：函数调用成本 vs 代码复制

Kotlin 的 inline 修饰符指示编译器在调用点直接将函数体复制替换，省去创建栈帧、参数传递、跳转和返回等运行时开销。对于高阶函数（函数参数类型为 lambda 或函数类型），每调用一次就会创建匿名类实例，内联可消除对象分配与虚调用。

4.2 使用场景：何时应该加上 inline

• 高阶函数参数：如 myScope { … }、Collection.map { … }，避免 lambda 对象分配。
• 泛型函数且需要实化泛型：inline fun <reified T> … 使泛型在字节码中保留。
• 性能热点路径：被调用超 10⁵ 次/秒的小函数。
• 工具函数：require()、check()、measureTimeMillis() 等标准库函数均为 inline。

4.3 控制内联粒度：noinline 与 crossinline

当一个函数有多个 lambda 参数，你可能只希望内联部分 lambda，用 noinline 标记其余参数，让编译器以普通匿名类方式处理它们，防止过度膨胀。

// 只有 lambda1 被内联，lambda2 保持对象形式
inline fun example(noinline lambda1: () -> Unit, lambda2: () -> Unit) {
    lambda1()
    doSomething()
    lambda2()
}

crossinline 用于解决“非局部返回”限制：内联函数的 lambda 参数中默认允许使用 return 直接返回外层函数。但若 lambda 被传递给另一层内联（如协程上下文）或不能直接 return 的位置，则需要用 crossinline 禁止非局部返回，同时仍保留内联效果。

// crossinline 禁止 lambda 内部使用非局部 return
inline fun runWithRetry(crossinline block: () -> Unit) {
    var attempt = 0
    while (attempt < 3) {
        block()                // 这里不能直接 return 外层函数
        attempt++
    }
}

fun test() {
    runWithRetry {
        if (retryable) return@runWithRetry  // 必须使用标签返回
        println("completed")
    }
}

4.4 内联决策流程

4.5 调试技巧：查看内联后的字节码

1. Kotlin 编译器选项：kotlinc -Xinline -d output myFile.kt 强制启用内联，再用 javap -c OutputKt.class 查看字节码。
2. IntelliJ IDEA：Tools → Kotlin → Show Kotlin Bytecode，勾选 “Skip past inlined functions” 可以观察最终展开结果。
3. 统计代码膨胀：对比内联前后的 .class 文件大小，使用 wc -c 或 IDE 的编译报告。

4.6 常见错误与规避

4.7 性能优化：度量与权衡

• 基准测试：使用 measureTimeMillis 或 JMH 对比内联前后调用 10⁷ 次高阶函数的耗时。
• 代码体积监控：CI 中增加 find . -name "*.class" -exec wc -c {} + 对比每版本体积。
• 逐函数决策：对热点路径优先使用 inline；对分支多、调用频率低的函数保留普通定义。
• 配合 ProGuard / R8：最终 APK 体积可再通过混淆器缩小内联带来的膨胀。