“undefined reference”是链接错误，发生在链接阶段，因链接器找不到函数或变量的定义；报错不含文件名和行号，只显示修饰后的符号名，如“undefined reference to 'xxx'”。
报错信息里有没有文件名和行号
有，基本是编译错误；没有，大概率是链接错误。编译器在处理单个 .cpp 文件时，一旦发现语法、类型或声明问题，会直接标出 foo.cpp:42:17 这样的位置。而链接器不看源码行，它只管符号——所以报错里全是 undefined reference to 'llvm::FunctionPass::runOnFunction(llvm::Function&)' 这种没行号、带修饰名的提示。
undefined reference to 出现在哪一步
如果是在 clang++ -c main.cpp -o main.o 阶段失败，那是编译错误（比如用了未声明的函数）；如果是在 clang++ main.o mypass.so -o tool 或 opt -load ./mypass.so 时崩，就是链接错误。常见陷阱：
-
opt -load失败但clang++编译通过，说明 Pass 的 so 文件本身能生成，但链接器找不到它依赖的 LLVM 符号（比如漏了target_link_libraries(LLVMCore)） - 用
nm -C mypass.so | grep FunctionPass能看到符号但运行时报undefined reference，说明链接顺序错了——LLVMCore必须排在LLVMAnalysis前面
Clang 报错里是否含 internal compiler error
出现 internal compiler error: Killed (program cc1plus) 不是代码写错了，是系统资源不够。这时候别改源码，去查内存和 swap：
- 用
free -h看可用内存，低于 4G 就容易触发 - 检查
/var/log/syslog里有没有Out of memory: Kill process记录 - 临时加 swap：用
dd if=/dev/zero of=/swapfile bs=1G count=4创建 4G 交换文件
这类错误既不是编译逻辑错，也不是链接配置错，而是构建环境卡在了编译器进程启动阶段。
IR 合法性问题导致的“假链接错误”
有些 opt -load 崩溃看起来像链接失败，实际是 IR 本身非法。LLVM 不会在加载 so 时校验输入 IR，而是在 Pass 第一次访问某条指令时断言失败，错误堆栈常被误读为符号缺失。验证方法很直接：
- 先跑
opt -verify -disable-output bad.ll，如果报错，说明 IR 有问题，跟你的 Pass 无关 - 再用
llvm-as 检查语法是否合法 - 如果
llc -march=x86-64 bad.ll -o /dev/null也失败，那 IR 已经坏到后端都啃不动了
真正容易被忽略的是：IR 错误不会阻止 so 编译成功，但它会让整个工具链在运行时才暴露问题，排查路径容易绕远。
