在 Kotlin 里，直接调用非空函数参数（比如 `func("arg")`）和显式写 `invoke("arg")` 效果一模一样，但一旦函数可能为 null，就必须借助安全调用操作符 + `invoke()` 才能保证空安全。

这是 Kotlin 新手经常遇到的困惑。

明明可以直接调用，为什么还要提供 `invoke()`？它们到底有什么区别？什么时候该用哪个？

先说结论

非空函数参数使用 `func(arg)` 和 `func.invoke(arg)` 完全等价。

但如果是可空函数类型，就必须写成 `func.invoke(arg)`，这样才能保证空安全。

为什么两种写法等价

函数类型在 Kotlin 底层，本质上是 `kotlin.FunctionN` 接口的实例。

例如 `(String) -> Unit`，对应的就是类似 `Function1` 的类型，而这个接口里定义了 `invoke()` 方法。

因此，下面两种写法编译后的字节码完全一致：

private fun mFun(mMethod: (String) -> Unit) {
    mMethod("Name")        //  推荐：简洁、惯用、可读性强
    mMethod.invoke("Name") //  等价，但冗余
}

既然等价，就优先用更简洁的直接调用。

Kotlin 编译器会自动帮你转换成 `invoke()`，没必要手动再写一遍。

`invoke()` 真正的价值

`invoke()` 并不是没用。

它真正重要的场景，是处理 可空函数类型。

如果一个函数参数可能为 null，比如 `((String) -> Unit)`，你不能直接对它写 `("arg")`。

这时编译器会直接报错，所以只能通过 `.invoke()` 来调用：

private fun mFun(maybeNullFunc: ((String) -> Unit)) {
    maybeNullFunc.invoke("Name") //  合法且安全
    // maybeNullFunc.("Name")    //  编译错误：不能对可空函数类型使用直接调用语法
}

这一点可以直接记住：

• 非空函数用 `func(arg)`
• 可空函数必须用 `func.invoke(arg)`

实践中还要注意两点

命名要反映语义

命名应该体现用途，不要使用匈牙利前缀。

像 `mMethod` 这种带 `m` 前缀的写法，在 Kotlin 里既不必要，也容易误导。

它实际上是函数参数，并不是成员变量。

更好的命名方式，是使用 `onResult`、`logger`、`handler` 这类能表达意图的名字。

这样做能明显提升代码可读性。

术语要严谨

`(String) -> Unit` 是函数类型，不是“方法”。

只有类或对象内部的成员函数，才叫“方法”。

而一个 lambda 表达式，比如 `{ println(it) }`，或者顶层函数引用，比如 `::log`，都叫函数值。

它们独立存在，不隶属于任何类。

把这些概念区分清楚，能减少团队沟通中的歧义。

几个正确示例

// 传入一个 String 成员函数引用（是 method，也是 function）
mFun(String::length) // 类型为 (String) -> Int，需适配签名（此处仅作说明）

// 传入一个 Lambda（是 function，但不是 method）
mFun { name -> println("Hello, $name") }

// 传入一个顶层函数引用
fun log(s: String) = println("[LOG] $s")
mFun(::log)

核心要点总结

• 非空函数 → 优先用 `func(arg)`：简洁、符合 Kotlin 惯例；
• 可空函数 → 必须用 `func.invoke(arg)`：唯一支持空安全调用的语法；
• 命名要准确：用 `handler`、`callback`、`transform` 等语义名替代 `mMethod`；
• 术语要严谨：区分 function（一等值）、method（类成员）、lambda（匿名函数字面量）——这直接影响代码可维护性与团队协作清晰度。