C++ 类成员函数的内联定义（inline）详解

1. 什么是内联函数？

inline 最初是给编译器的优化建议：希望把函数调用处直接替换为函数体，省去函数调用的栈帧建立和跳转开销，适合体积小、调用频繁的函数。

但需要注意两点：

• inline 只是建议，不是强制 。编译器可以忽略它，也可能对没写 inline 的函数自行内联。
• 在现代 C++ 中，inline 更重要的语义是允许函数在多个编译单元中重复定义（遵守 ODR，单一定义规则），这对头文件中的定义至关重要。

2. 成员函数的两种内联定义方式

方式一：在类体内直接定义（隐式 inline）

class MyClass {
public:
    int add(int a, int b) {   // 类体内定义，自动成为 inline
        return a + b;
    }
};

写不写 inline 都一样，所以通常省略。

方式二：类内声明，类外定义时加 inline

// MyClass.h
class MyClass {
public:
    int add(int a, int b);    // 仅声明
};

inline int MyClass::add(int a, int b) {   // 类外定义，需显式加 inline
    return a + b;
}

类外定义的成员函数不会 自动成为 inline，需要显式写 inline。inline 写在类外的定义处即可，写在类内声明处也可以，但定义处必须能看到它。

3. 为什么头文件中的类外定义必须加 inline？

// MyClass.h（没有 inline）
class MyClass { public: int add(int a, int b); };
int MyClass::add(int a, int b) { return a + b; }  // ❌

如果多个 .cpp 文件都 #include "MyClass.h"，每个编译单元都会生成一份 MyClass::add 的定义，链接时会报 multiple definition 错误。加上 inline 后，链接器允许多份相同定义并合并为一份。

反过来，如果函数定义放在 .cpp 文件中，就不需要也不应该加 inline。

4. 对比总结

定义方式	是否隐式 inline	需要显式写 inline 吗
类体内直接定义	是	不需要
类内声明 + 头文件中类外定义	否	需要
类内声明 + .cpp 中类外定义	否	不需要（也不应加）

补充：constexpr 成员函数同样隐式 inline；C++17 起，static constexpr 数据成员也隐式 inline。

5. 什么时候适合用 inline？

• 只有几行的小函数，如 getter、setter、简单运算
• 调用非常频繁的短函数
• 需要在头文件中定义的函数（为满足 ODR）

不适合的情况：

• 函数体较大、含复杂循环或递归：内联会导致代码膨胀，反而可能降低指令缓存命中率，应放在 .cpp 中
• 需要取函数地址或做虚函数调用时，内联效果有限

6. 注意：模板不需要 inline

template <typename T>
class Container {
public:
    T& operator[](size_t idx) { return data[idx]; }  // 类体内定义，天然 inline
private:
    T* data;
};

模板的定义本身就可以出现在多个编译单元中，不会触发重复定义错误，因此不需要 为此额外加 inline。

7. 最佳实践

1. 小函数直接写在类体内，简洁清晰。
2. 较大的函数声明在头文件，定义放在 .cpp 中。
3. 必须在头文件中类外定义时，加上 inline。
4. 不要依赖 inline 来保证性能，是否内联最终由编译器决定；确实需要强制内联时，使用 __attribute__((always_inline))（GCC/Clang）或 __forceinline（MSVC），并用性能测试验证。

总结

类体内定义的成员函数默认是 inline；在头文件中类外定义时必须显式加 inline，否则多个编译单元包含时会出现重复定义的链接错误。

---

---

（以下为文章修改日志，请忽略）

原文中需要纠正的问题

1. 「模板类/模板函数中的成员函数必须写 inline」是错误的。 模板本身不需要 inline。模板的定义放在头文件里，被多个编译单元包含也不会触发重复定义错误。示例里的 operator[] 是类体内定义，本来就隐式 inline，写不写都一样。
2. 「超过 20-30 行的大函数写在类外并显式使用 inline」自相矛盾。 大函数不适合内联，应该放在 .cpp 里，不加 inline。
3. 「C++11 后很少手写 inline，因为类体内定义默认就是 inline」因果不对。 类体内定义隐式 inline 是一直如此，和 C++11 无关。
4. 「想强制内联」说法不准确。 inline 无法强制内联，要用编译器扩展（GCC/Clang 的 __attribute__((always_inline))，MSVC 的 __forceinline）。
5. 漏掉了 inline 在现代 C++ 中最重要的含义，即 ODR（单一定义规则）。 现代编译器是否内联主要由优化器自己判断，inline 的实际作用是允许同一个函数定义出现在多个编译单元中。如果在头文件里类外定义成员函数却不加 inline，多个 .cpp 包含该头文件时就会出现 multiple definition 链接错误。这才是「类外定义必须写 inline」的真正原因。
6. 结构冗余。 原文的方式（1）和（4）本质相同，（2）和（3）也相同，合并后更清晰。