inline是编译器建议而非强制指令，是否内联由编译器根据函数大小、控制流复杂度、调用频次和优化等级等综合决定；类内定义的成员函数默认inline，类外定义需显式声明且必须置于头文件中以避免odr错误；现代编译器在优化模式下会自动内联合适函数，盲目使用可能导致代码膨胀和调试困难。
inline 是编译器的建议，不是强制指令
你写 inline，只是告诉编译器“这个函数我希望能被内联展开”，但最终是否展开，完全由编译器决定。它会综合考虑函数体大小、控制流复杂度（比如有没有 for、while、switch）、调用频次、当前优化等级（如 -O2 更倾向内联）等因素。哪怕你给一个 50 行带递归的函数加 inline，编译器大概率直接忽略。
类内定义的成员函数默认就是 inline 的
在类声明内部直接写函数体，比如：
class Vec {
public:
int size() const { return m_size; } // 自动视为 inline
private:
int m_size;
};
这种写法等价于显式写 inline int size() const { ... }。但注意：如果函数在类外定义（哪怕只有一行），就必须显式加 inline 关键字，否则多个源文件包含该头文件时可能触发 ODR（One Definition Rule）违规，链接时报 duplicate symbol 错误。
inline 函数必须定义在头文件中
因为内联发生在编译期，每个使用它的翻译单元都需要看到完整定义。常见错误是把 inline 函数写在 .cpp 文件里，结果其他文件调用时只能走普通函数调用，甚至链接失败。
- ✅ 正确：定义放在
utils.h，所有包含它的 .cpp 都能参与内联决策 - ❌ 错误：定义放在
utils.cpp，其他文件看不到函数体，无法内联，还可能因未定义引用报错 - ⚠️ 特殊情况：若用
static inline，可放在 .cpp 中，但仅限本文件使用，失去跨文件复用意义
别为了“性能”盲目加 inline
现代编译器（GCC/Clang/MSVC）在开启优化后（如 -O2）会自动对合适的小函数做内联，哪怕你没写 inline。反过来，加了 inline 却不被采纳，也不会报错或警告——它就静静失效了。
真正容易被忽略的是副作用：过度内联会让代码体积膨胀（code bloat），可能挤出 CPU 指令缓存，反而降低性能；调试时也更难单步——因为函数体已消失，变成内联后的汇编指令。所以优先让编译器自己判断，只在明确知道调用热点且函数极简（比如 getter/setter、简单算术）时，才用 inline 显式提示。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
