因为C++采用分离式编译，每个.cpp独立编译为.obj，若头文件中含非inline函数定义且被多个.cpp包含，则链接时出现多个同名符号，违反ODR规则，触发LNK2005错误；仅inline、constexpr（隐式inline）和模板函数可安全定义在头文件中。
为什么函数定义放进头文件会报重复定义错误
因为 C++ 的每个 .cpp 文件单独编译成目标文件，如果头文件里有非内联的函数定义，而该头文件被多个 .cpp 包含，链接时就会看到多个同名函数符号，触发 LNK2005（MSVC）或 multiple definition（GCC/Clang）错误。
哪些函数可以安全地定义在头文件里
只有以下三类函数能直接写在头文件中，且不会引发链接冲突：
-
inline函数：编译器允许在多个翻译单元中存在相同定义，链接器只保留一份 -
constexpr函数（C++11 起）：隐式 inline，且必须满足常量表达式约束 - 模板函数（包括函数模板和特化）：模板定义必须可见于实例化点，通常只能放在头文件中
例如：
// utils.h
#ifndef UTILS_H
#define UTILS_H
inline int add(int a, int b) {
return a + b;
}
template<typename T>
T max(T a, T b) {
return (a > b) ? a : b;
}
#endif
不小心把普通函数定义放头文件里了怎么办
常见症状是：编译通过，但链接失败，错误信息类似 error LNK2005: xxx already defined in xxx.obj。
立即学习“C++免费学习笔记（深入）”；
修复方式很简单，但要注意区别：
- 如果函数逻辑简单、调用频繁 → 加
inline前缀（推荐） - 如果函数较大或含静态局部变量 → 必须移出头文件，只留声明，定义放到对应的
.cpp中 - 如果函数仅被单个
.cpp使用 → 改用static或匿名命名空间，但此时它就不是“供头文件使用者调用”的接口了
注意：static inline 在 C++ 中不必要（inline 已足够），且 static 会为每个 TU 生成独立副本，浪费空间。
头文件里定义函数时容易忽略的细节
即便用了 inline，也得小心这些边界情况：
- 函数体里调用了未声明的全局变量或非内联函数 → 这些依赖仍需在某个
.cpp中定义，否则链接失败 - 函数含
static局部变量 → 每个 TU 会各自初始化一份，行为可能不符合预期（比如计数器在不同源文件里独立计数） - 模板函数里用了未导出的辅助函数 → 辅助函数本身仍需满足 ODR 规则，不能只在头文件里定义
真正安全的头文件函数，要么纯计算无副作用，要么所有依赖都可内联或模板化。一旦牵扯到状态、IO、第三方库调用，就该回归 .h+.cpp 分离模式。
