头文件中定义非内联函数会触发 multiple definition 错误，因多个 .cpp 包含该头文件后生成重复符号；应声明放 .h、定义放 .cpp，或加 inline/constexpr；模板和类内定义成员函数默认内联，不违反 ODR。
为什么头文件里定义函数会触发 multiple definition
因为 C++ 的每个 .cpp 文件单独编译成目标文件，如果头文件里写了非内联函数定义（比如 void foo() { return; }），而这个头文件又被多个 .cpp 包含，链接时就会发现多个同名符号，报 multiple definition of 'foo'。
常见诱因包括：把函数体直接写在 .h 里、误用 static 修饰全局函数（仍可能跨 TU 冲突）、或忘了加 inline 或 constexpr。
- 只在头文件中声明函数（
void foo();），定义放到对应的.cpp中 - 若必须在头文件中定义，加
inline（C++17 起推荐）：inline void foo() { ... } -
constexpr函数默认内联，但仅限于满足常量表达式要求的函数 - 避免用
static修饰非局部函数来“隐藏”——它会在每个 TU 生成一份副本，不解决链接冲突，还浪费空间
模板函数和 constexpr 变量为啥不报错
模板函数（包括函数模板和类模板的成员函数）本身不生成代码，只有被实例化时才生成，且编译器保证同一实例在多个 TU 中只保留一份定义（ODR 约定）。constexpr 变量（如 constexpr int x = 42;）默认是 inline 的（C++17 起），也受 ODR 约束。
- 函数模板定义可放心放头文件，无需额外修饰
- C++17 前的
constexpr变量需手动加inline才能跨 TU 定义，否则仍是“定义多次”错误 - 类内定义的成员函数（哪怕没写
inline）自动成为内联函数，所以通常不会出问题
如何快速定位是哪个符号重复了
链接器报错一般会带具体符号名，例如：multiple definition of 'Logger::instance()'。但如果信息被截断或太泛，可以用工具辅助排查：
立即学习“C++免费学习笔记（深入）”；
- 加
-Wl,--verbose（GCC/Clang）让链接器输出所有输入的目标文件和符号来源 - 用
nm -C your_obj.o | grep 'your_symbol'检查每个.o是否导出了该符号（T表示定义，U表示未定义引用） - 用
objdump -t your_obj.o | grep your_symbol查看符号类型和绑定属性 - 检查是否不小心在多个
.cpp里写了同名全局变量（比如int g_counter = 0;）——这种比函数更容易漏掉
extern "C" 和 inline 混用要注意什么
给 C 链接约定的函数加 inline 是合法的，但必须确保所有包含该头文件的 TU 都看到完全一致的定义（包括 extern "C" 修饰），否则可能因 ABI 不一致导致链接失败或运行时异常。
- 正确写法：
extern "C" inline void c_style_helper() { ... } - 不要在某些 TU 里用
extern "C"，另一些里不用；也不要拆成声明+定义（头文件里声明extern "C" void f();，某个.cpp里定义void f() {...}），否则失去 C 链接性 -
extern "C"不影响内联行为，只是控制符号名修饰（mangling），所以和inline是正交的
const int VERSION = 1; 在头文件里看似安全，但如果没加 inline（C++17）或 constexpr，它就不是内联变量，照样触发 multiple definition。 
