Clang报undefined symbol基本可断定是链接阶段失败：编译器看到声明但找不到定义，主因包括目标文件未参与链接、库未正确引入、C++名称修饰导致符号不匹配、ABI或标准库混用、动态库路径错误或符号未导出。
Clang报undefined symbol，基本可以断定是链接阶段失败——编译器看到了声明，但找不到定义。不是语法错，也不是头文件漏了，而是目标文件或库没连上、ABI不匹配、或者符号根本没导出。
检查符号是否真的在目标文件里
先确认问题出在哪个环节：是你的代码没实现？还是调用的库没链接？还是名字被C++修饰搞丢了？
- 用
nm -C your_object.o | grep your_function_name查目标文件里有没有这个符号；如果显示U（undefined），说明它只被引用、没被定义 - 如果是C++函数，直接搜函数名可能找不到——得用
c++filt反解修饰名，比如c++filt _ZNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEE9_M_createERmm - 若符号在
.o里是T（text）或D（data），但最终可执行文件里没了，说明链接时被丢弃或未参与链接
确保源文件参与编译和链接
常见低级但高频的问题：函数写在utils.cpp里，但编译命令或构建脚本里根本没包含它。
- CMake中漏掉
add_library或target_sources，导致.cpp没进编译流程 - Xcode项目里，
.m或.mm文件没加进Compile Sources列表（比如AppDelegate.m被漏掉就报_OBJC_CLASS_$_AppDelegate未定义） - Android
Android.mk中，LOCAL_SRC_FILES没列全，或LOCAL_STATIC_LIBRARIES没填对依赖库名
排查C++ ABI和标准库混用
macOS上Clang默认用libc++，Linux上GCC常配libstdc++，混在一起就容易崩。报std::string::compare或_ZNSt...开头的符号找不到，八成是这问题。
- 用
otool -L your_binary（macOS）或ldd your_binary（Linux）看实际链接了哪个C++ runtime - 统一指定标准库：
clang++ -stdlib=libc++或clang++ -stdlib=libstdc++，并确保所有依赖库也是同一体系编译的 - 遇到PyTorch/CUDA等第三方包，检查它们的ABI版本：加
-D_GLIBCXX_USE_CXX11_ABI=0强制旧ABI，或降级torch适配系统库
动态库路径与符号可见性
运行时报undefined symbol，而编译链接时没报，说明是dlopen或运行时加载阶段出的问题。
-
LD_LIBRARY_PATH没设对，或runpath缺失：用readelf -d your_binary | grep runpath确认路径是否包含依赖库所在目录 - 共享库本身没导出该符号：用
nm -D libxxx.so | grep your_symbol验证，若无输出，可能是编译时加了-fvisibility=hidden且没显式标记__attribute__((visibility("default"))) - Android NDK高版本禁用非稳定API（如
android::RefBase::decStrong），即使头文件能include，链接时也会失败——必须用LOCAL_LDLIBS链接对应系统库，或改用稳定接口
最麻烦的情况是多个库交叉依赖且ABI/标准库/架构（x86_64 vs arm64）全都不一致，这时候单靠加-l或改flag很难根治，得从构建源头统一工具链和依赖版本。
