inline函数需在头文件中定义，语法为“inline 返回类型 函数名(参数) {函数体}”，因ODR规则要求所有翻译单元可见其定义，否则链接失败；类内定义成员函数默认inline。
inline 函数怎么写：语法和基本规则
在 C++ 中，inline 是一个建议性关键字，不是强制内联指令。编译器有权忽略它，尤其当函数体过大、含循环或递归时。
写法很简单：在函数定义前加 inline，且必须是**定义**（不是声明），否则链接会出错：
// 正确：定义在头文件中（推荐）
inline int add(int a, int b) {
return a + b;
}
<p>// 错误：只在头文件里声明 inline，定义在 .cpp 里
// 头文件：
inline int mul(int a, int b); // ❌ 这只是声明，不满足 ODR 要求</p><p>// .cpp 文件：
int mul(int a, int b) { return a * b; } // ❌ 编译器看不到 inline 定义，无法内联，还可能链接失败
-
inline必须出现在函数**所有翻译单元可见的定义处**，最稳妥就是直接写在头文件里 - 类内定义的成员函数（哪怕没写
inline）默认隐式为inline - C++17 起支持
inline变量，但函数层面仍是老规则
为什么 inline 函数必须定义在头文件里
根本原因是 C++ 的**一次定义规则（ODR）** 和编译模型：每个 .cpp 文件（翻译单元）独立编译，链接器最后合并符号。如果 inline 函数只在一个 .cpp 里定义，其他文件调用时既看不到函数体（无法内联），又找不到外部符号（因为 inline 隐含 static 链接属性），就会报 undefined reference。
头文件的作用是让定义“到处可见”：
立即学习“C++免费学习笔记（深入）”；
- 每个包含该头文件的
.cpp都获得一份相同的inline函数定义 - 编译器可据此决定是否内联；即使不内联，链接器也允许多个相同
inline定义共存（ODR 特例） - 若定义放在
.cpp里，只有它自己能用 —— 其他文件既不能内联，也无法链接到它
inline 不起作用的常见原因
写了 inline 却没被内联？不是编译器“不听话”，而是它按优化逻辑做了合理判断：
- 函数体太长（如超过 10 行、含
for/while、switch或异常处理） - 有取地址操作：
&add会让编译器必须生成真实函数地址，放弃内联 - 开启了低优化等级（如
-O0），GCC/Clang 默认关闭内联优化 - 跨编译单元调用（即使定义在头文件，但头文件没被包含，或用了预编译头等机制导致未生效）
验证是否真被内联：开 -O2 编译后看汇编（g++ -S -O2），或检查调试信息中是否有函数调用指令（call add 消失了通常说明内联成功）。
替代方案和现代建议
手动加 inline 已越来越不必要。现代编译器（GCC、Clang、MSVC）在 -O2 及以上会自动对小函数做内联决策，比人更准。
- 优先靠编译器自动优化，而不是盲目加
inline - 真正需要强制内联（极少数场景，如性能关键热路径）用
__attribute__((always_inline))（GCC/Clang）或__forceinline（MSVC），但要慎用 —— 可能增大代码体积、破坏 CPU 指令缓存局部性 - 模板函数天然适合头文件定义，也默认 inline；不必额外加
inline关键字
最容易被忽略的一点：头文件里定义 inline 函数时，若函数依赖了未声明的类型或宏，而该头文件又被多个地方包含，就容易因包含顺序引发 ODR 违反或编译失败 —— 所以它必须自完备，或显式包含所需头文件。
