普通成员函数定义必须放在.cpp中以避免multiple definition错误，因其默认具有外部链接，若在头文件中定义，多个源文件包含该头文件时会违反c++的one definition rule（odr），导致链接阶段出现重复定义错误。
普通成员函数定义放.cpp是为避免重复定义
头文件被多个源文件包含时，如果成员函数定义（而非声明）也放在 .h 里，每个 .cpp 编译单元都会生成一份该函数的目标代码，链接阶段会报 multiple definition of XXX 错误。
这是因为普通函数默认具有外部链接（extern），而 C++ 的“一个定义规则”（ODR）禁止同一实体在多个翻译单元中定义。
-
class A { public: void foo(); };—— 这只是声明，可重复出现在多个.h中（只要被包含） -
void A::foo() { ... }—— 这是定义，只能出现在一个.cpp文件中 - 若把
void A::foo() { ... }写进A.h，又在main.cpp和util.cpp中都#include "A.h"，就违反 ODR
内联函数必须放头文件，否则调用点看不到函数体
标记为 inline 的成员函数（或在类体内直接定义的函数）会被隐式视为内联，编译器需要在调用处看到完整函数体才能展开。如果把它写在 .cpp 文件里，其他文件包含头文件后只看到声明，无法内联，甚至可能因未定义而链接失败。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 类内定义：
class A { void f() { /* body */ } };→ 隐式inline，必须放头文件 - 显式
inline声明+定义：inline void A::f() { ... }→ 同样必须放头文件 - 若硬塞进
A.cpp，main.cpp调用A::f()时只有声明，链接时报undefined reference to A::f()
模板成员函数不能放.cpp，除非显式实例化
模板不是真实函数，而是生成函数的“蓝图”。编译器只有在遇到具体类型（如 vector<int></int>）时才实例化。若把 template<typename t> void Stack<t>::push(const T&)</t></typename> 定义放在 Stack.cpp 中，其他文件包含 Stack.h 后使用 Stack<string></string>，编译器在那个翻译单元里看不到 push 的实现，无法生成 Stack<string>::push</string>，最终链接失败。
- 常规解法：把整个模板类（声明+定义）都放进
.h或.hpp - 折中解法：在
Stack.cpp末尾加template class Stack<int>;</int>和template class Stack<double>;</double>—— 仅对已知类型生效，新增类型需同步补实例化 - 漏掉某个类型，就会出现
undefined reference to Stack<t>::push</t>，且错误信息里T是具体类型名，比如Stack<:string>::push</:string>
静态成员函数和静态数据成员的初始化位置很关键
静态成员属于类而非对象，其定义（分配存储）必须唯一。声明可放头文件，但定义必须在 .cpp 中完成，否则又触犯 ODR。
- 声明（
A.h）：class A { static int count; };—— 合法，可多次包含 - 定义（
A.cpp）：int A::count = 0;—— 必须且只能有一处 - const static 整型成员例外：可在类内直接初始化（
static const int version = 1;），但取地址时仍需在.cpp中定义（const int A::version;） - 非整型 const static 成员（如
static const std::string name;）必须在.cpp中定义并初始化
实际项目里最容易出问题的是把模板函数或内联函数往 .cpp 里塞，然后纳闷为什么链接不过——错误信息往往不提“模板”或“inline”，只冷冰冰甩一句 undefined reference，得倒着查声明、定义、实例化三者是否都在可见范围内。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
