函数的声明和定义都在头文件中注意事项

将函数的声明和**定义（实现）**都放在头文件（.h或.hpp）中，是 C++ 开发中一种特殊但必要的模式（常见于模板、内联函数、高性能库）。然而，这种做法打破了传统的“声明在头文件，定义在源文件”的分离原则，如果处理不当，会引发链接错误、代码膨胀、编译缓慢甚至未定义行为。

一、核心机制：为什么通常会出错？

在深入细节前，必须理解 C++ 的编译模型：翻译单元（Translation Unit, TU）。

1. 每个.cpp文件及其包含的所有头文件构成一个独立的翻译单元。
2. 编译器单独编译每个 TU，生成目标文件（.o或.obj）。
3. 链接器将所有目标文件合并，解析符号引用。

问题根源：
如果你在头文件中直接写void func() { ... }而没有特殊修饰：

• TU A包含了该头文件 -> 生成了func的代码副本（符号func被定义）。
• TU B也包含了该头文件 -> 又生成了func的代码副本（符号func再次被定义）。
• 链接阶段：链接器发现两个