函数定义重复导致链接失败，因odr规则要求非内联函数在程序中只能有一个定义，头文件中误写函数体并被多个.cpp包含即触发multiple definition错误。
函数定义重复导致链接失败
当你把同一个函数的定义（不是声明）写在多个 .cpp 文件里，编译器会为每个文件生成一份该函数的目标代码，链接器在最后合并时发现多个同名定义，就会报 multiple definition of 'xxx'。这不是语法错误，编译阶段完全通过，但链接直接失败。
- 典型场景：在
utils.h里写了int add(int a, int b) { return a + b; }，又在main.cpp和test.cpp中都#include "utils.h" - 根本原因：C++ 的 ODR（One Definition Rule）规定，非内联函数在一个程序中只能有一个定义
- 注意：
inline函数、模板函数、static函数不受此限，但它们的作用域或语义已改变
头文件里混入函数定义的常见误操作
很多初学者以为“头文件就是放声明的地方”，结果一不留神把带函数体的定义也塞进去了。只要这个头文件被两个及以上 .cpp 包含，就必然触发重复定义。
- 错误写法：
utils.h中出现void log(const char* msg) { printf("[LOG] %s\n", msg); } - 正确做法：头文件只放声明，如
void log(const char* msg);；定义统一放在utils.cpp中 - 如果非要头文件里写实现（比如模板），必须加
inline或确保只被一个翻译单元包含（例如用#pragma once+ 单次包含约定）
声明与定义分离不彻底引发的链接错误
声明写了，定义也写了，但链接器还是报 undefined reference to 'xxx'——大概率是定义没被编译进最终链接过程，或者名字不匹配。
- 检查是否漏加
.cpp文件到构建系统：VS 中没把utils.cpp加入“源文件”过滤器；Makefile 里没列进依赖；CMakeLists.txt 没add_executable(... utils.cpp) - 检查函数签名是否完全一致：返回类型、参数类型、
const修饰、noexcept等任何一处不匹配，都会让链接器认为是另一个函数 - 检查命名空间：在
namespace foo { void bar(); }中声明，却在全局作用域定义void bar() { ... }，两者不是同一个符号
跨文件调用时容易忽略的细节
即使定义和声明分离了，还有几个隐形门槛会影响实际调用成功。
-
static修饰符会让函数仅在当前.cpp内可见，其他文件即使声明了也无法链接到它 - Windows 下 DLL 导出需要
__declspec(dllexport)，否则默认不导出符号 - C++ 函数名会被编译器修饰（name mangling），如果头文件里用
extern "C"声明，但定义没加对应修饰，链接会失败 - 头文件未被正确包含：路径写错、大小写不符（尤其 Linux/macOS）、拼写错误如
#include "utlis.h"
真正卡住人的往往不是“能不能写”，而是“谁能看到、谁参与链接、名字对不对”。多文件协作时，定义的位置、可见性、命名一致性，三者缺一不可。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
