Swift中@inlinable属性是什么？求通俗解释及优势说明

核心含义 #

@inlinable是Swift的函数属性，作用是把函数的实现代码“公开”给调用它的外部模块，而非只暴露函数的名字、参数这类接口信息。

正常情况下，如果你写了一个工具库（模块），里面的函数默认只有接口会被外部模块看到，实现代码是藏在库内部的。外部调用这个函数时，程序会跳转到库内的函数代码去执行。但加了@inlinable之后，编译器会把函数的实现代码打包到库的公开接口中，外部模块调用该函数时，编译器会直接把函数代码“复制粘贴”到调用位置，替代原来的函数调用指令。

比如你给出的示例：

@inlinable func printPlusOne(_ num: Int) {
    print("My number: \(num + 1)")
}

当外部模块调用printPlusOne(5)时，编译器会直接把这段代码替换成：

print("My number: \(5 + 1)")

相当于调用方的代码里直接写了打印语句，而非去调用你的函数。

主要优势 #

• 性能优化：减少函数调用的额外开销（比如函数跳转、栈帧创建销毁等操作），逻辑简单的小函数，这种提升尤为明显。
• 跨模块编译优化：调用方的编译器可以结合上下文做更深层优化。比如如果传入的num是常量（如上面的5），编译器会直接算出5+1=6，最终生成的代码是print("My number: 6")，省去运行时的计算步骤。
• 兼容内部依赖：如果你的函数用到了模块内部的私有函数、变量，加了@inlinable之后，这些内部符号会被临时暴露给外部模块，不会出现“找不到符号”的编译错误（注意不要随意暴露内部细节，避免破坏封装性）。

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