在 Rust 中，
#[inline] 和 #[inline(always)] 的区别主要在于对编译器的决策权和强制力。1. #[inline] (建议)
这是对编译器的暗示/建议。
- 功能：它告诉编译器，这个函数是一个内联的候选者。
- 编译器的决定：编译器会根据自己的启发式算法（代码量大小、调用频率等）来决定是否真正进行内联。如果编译器认为内联会导致代码膨胀严重或者反而降低性能，它可能会拒绝内联。
- 跨 Crate 关键点：在 Rust 中，如果不加
#[inline]，一个函数通常不能在定义它的 Crate 之外被内联。加上这个标签后，编译器会将该函数的中间代码（LLVM IR）放入生成的库文件中，使得其他 Crate 在调用它时能够进行内联优化。
2. #[inline(always)] (强制)
这是对编译器的强力指令。
- 功能：它极大地提高了内联的权重，几乎是强制要求编译器将该函数内联到每一个调用点。
- 强制力：除非在某些极端物理条件下（比如循环递归、函数指针调用或编译器底层无法处理的情况），编译器必须服从这个指令。
- 风险：过度使用会导致生成的二进制文件体积急剧增加（代码膨胀），有时反而会因为破坏了 CPU 的指令缓存（Instruction Cache）而降低运行速度。
3. 为什么需要分这两个级别？
| 维度 | #[inline] | #[inline(always)] |
|---|---|---|
| 控制权 | 编译器拥有最终决定权 | 开发者拥有控制权 |
| 典型用途 | 跨 Crate 的小型常用函数 | 对性能极其敏感且非常短小的热点路径代码 |
| 安全性 | 比较平衡，不容易翻车 | 可能导致二进制文件臃肿，甚至性能下降 |
4. 开发建议
- 默认不加：现代 Rust 编译器（基于 LLVM）非常聪明，能够自动识别大部分需要内联的热点代码。
- 库作者加
#[inline]：如果你写的是一个被频繁调用的工具库函数（如简单的 Getter 或数学计算），加上#[inline]允许下游用户享受内联优化。 - 慎用
#[inline(always)]：只有在经过 Profile（性能分析） 后，发现编译器由于某些原因未能自动内联某个极小的热点函数，且确实能显著提升吞吐量时，才考虑使用。
总结：
#[inline] 是“你可以考虑内联我”，而 #[inline(always)] 是“你必须内联我”。在现代编译器环境下，信任编译器通常是更好的选择。