Clang编译多个文件时链接失败，绝大多数情况不是编译器问题，而是符号未被正确提供或找到：函数仅在头文件声明而未在任何.cpp中定义、helper.cpp未加入项目、static修饰导致符号不可见、模板定义误放.cpp中、或链接命令遗漏目标文件（如utils.o）或库（如-lm）。
Clang 编译多个文件时链接失败，绝大多数情况不是编译器问题，而是符号没被正确提供或找到——核心在于“谁定义了函数，谁负责让链接器看见它”。
为什么 clang++ main.cpp utils.cpp 有时会报 undefined reference to 'xxx'
Clang 对每个 .cpp 文件单独编译成目标文件（.o），再统一链接。如果某个函数只在头文件里声明、却没在任何 .cpp 中实现，链接阶段就找不到它的地址。
- 常见场景：你在
helper.h里写了void do_work();，但忘了在helper.cpp里写函数体 - 更隐蔽的情况：
helper.cpp没被加进项目（Dev-C++ 里右键项目 → “添加文件”漏掉了） - 或者你用了
static修饰函数，导致该函数只在本文件可见，其他.cpp调用时链接器根本看不到
clang++ -c 分步编译后链接失败，怎么办
分步编译（先 -c 再 ld 或 clang++ 链接）更容易暴露遗漏，但也更依赖你手动拼全所有目标文件。
- 必须确保每个
.cpp都执行了clang++ -c file.cpp -o file.o，且没有编译错误（哪怕一个.o没生成，链接就缺一块） - 链接命令里要列全所有
.o文件，例如：clang++ main.o utils.o -o app，漏掉utils.o就会报未定义引用 - 如果用了库（比如
sqrt()），光有.o不够，还得显式加-lm：clang++ main.o utils.o -lm -o app
模板函数放在 .cpp 里会导致链接失败
C++ 模板不是普通函数——它需要在使用它的每个翻译单元里生成具体代码。把模板定义写在 .cpp 里，等于只在那个文件里实例化了一次，其他文件调用时链接器找不到对应版本。
- 典型错误：
template声明在T max(T a, T b); utils.h，定义却写在utils.cpp - 正确做法：模板的声明和定义都放在头文件（
utils.h）里，让每个包含它的.cpp都能当场生成所需特化版本 - 极少数情况可用显式实例化（
template int max），但必须确保该实例化语句所在(int, int); .cpp被编译并参与链接
Dev-C++ 下 Clang 链接失败，容易忽略的配置点
Dev-C++ 默认用 MinGW，换 Clang 后很多路径和库名不兼容，错误常藏在配置里。
- 检查“工具 → 编译器选项”里 Clang 路径是否指向
clang++.exe（不是clang.exe），否则 C++ 标准库可能不加载 - 项目选项 → “参数” → “链接器” 里加的库名必须带前缀，比如数学库写
-lm，而不是libm.a或m - Windows 上 Clang 默认用 MSVC 工具链，若你混用了 MinGW 的
libstdc++，ABI 不匹配也会导致符号找不到（尤其涉及std::string等）
最麻烦的其实是“看起来编译成功，但链接失败”——因为编译阶段不检查函数是否真有定义。盯住 undefined reference to 后面那个名字，直接去搜它在哪声明、在哪定义、定义的文件有没有被编译进项目，比调参数更快。
