Kotlin伴生对象内定义扩展函数的语法作用与工作机制

你贴的这段代码是Kotlin里成员扩展函数的典型写法，不是普通的全局扩展，具体的特性和逻辑如下：

实际作用 #

• 这段代码不是给ClassName1或者它的伴生对象加方法，扩展函数的接收者明确写的是ClassName2，本质是给ClassName2新增了一个叫funName的方法能力，但这个能力不是全局开放的，是挂靠在ClassName1的伴生对象作用域下的。
• 这种写法的核心价值是收拢扩展能力：如果某个针对ClassName2的扩展逻辑只和ClassName1的业务强相关，没必要开放成全局扩展让所有地方都能调用，用这种写法就能把扩展锁在ClassName1的相关上下文里，避免全局命名空间被大量无关扩展污染，符合最小暴露的代码设计原则。
• 举个直观的使用例子：

class ClassName1 {
    companion object {          
        fun ClassName2.funName()=""
        // 这个作用域内可以直接调用
        fun test() {
            val obj = ClassName2()
            val res = obj.funName() // 编译通过，正常运行
        }
    } 
}

// 类外部直接调用
fun testOutside() {
    val obj = ClassName2()
    obj.funName() // 直接报编译错误，找不到这个方法
}

生效范围 #

• 默认可直接调用的范围只有ClassName1的伴生对象代码块内部，这里不需要任何额外导入、上下文声明，就能直接给ClassName2的实例调用funName()。
• 如果你在类外部手动导入了这个扩展路径，或者用with(ClassName1)把ClassName1的伴生对象作为上下文接收器，也能调用到这个方法，但常规工程实践里很少这么用，这类成员扩展本来就是为了做内部逻辑收拢设计的。
• 其余所有没有引入对应上下文、没有手动导入该方法的代码区域，完全感知不到这个扩展的存在，ClassName2的实例不会提示这个方法，强行调用会直接编译失败。

运行原理 #

• Kotlin的所有扩展函数都不会真的修改目标类的字节码，不会往ClassName2里插入新的成员方法，扩展本质是编译器帮你做的语法糖。
• 定义在伴生对象里的这个扩展，编译后会生成一个归属在ClassName1.Companion类下的静态方法，方法签名等价于Java里的public static final String funName(ClassName2 receiver)，方法的第一个参数就是扩展的调用者实例。
• 当你在合法作用域里写className2Instance.funName()的时候，编译器会自动把这段代码替换成对上述静态方法的调用，把调用实例作为第一个参数传入，整个过程没有反射、没有运行时的类修改，执行效率和普通静态方法完全一致。
• 这类扩展始终是静态分发的，不会产生多态：如果ClassName2本身已经定义了签名完全一致的成员方法funName()，不管你在什么作用域调用，永远会优先执行ClassName2自己的成员方法，这个扩展方法不会生效。

内容的提问来源于stack exchange，提问作者Imane