InitializeNativeTarget() 必须在JIT或codegen前调用，否则LLVM将abort或返回空指针；它注册主机支持的目标后端（如X86、ARM），缺失则llc和ExecutionEngine均失败。
InitializeNativeTarget() 必须在 JIT 或 codegen 前调用
不调用 InitializeNativeTarget() 就尝试生成机器码，LLVM 会直接 abort 或返回空指针——这不是警告，是硬性失败。这个函数负责注册当前主机支持的所有目标后端（比如 X86、ARM、AArch64），没有它，llc 找不到后端，ExecutionEngine 无法创建 JIT 编译器。
常见错误现象：
llc: error: unable to create target: 'No available targets are compatible with triple 'x86_64-unknown-linux-gnu''- JIT 初始化时
ExecutionEngine::createJITCompilerForModule返回nullptr -
TargetRegistry::lookupTarget返回nullptr，即使你传了正确的 triple
正确做法：
- 在
main()开头或 JIT 初始化前，必须调用InitializeNativeTarget() - 如果需要额外目标（比如你手动编译了 RISCV 后端但没启用），还要补上
InitializeNativeTargetXXX()，例如InitializeNativeTargetRISCV() - 注意：C++ 头文件需包含
<llvm/Support/TargetSelect.h>
Triple 不匹配会导致 Target 查找失败
LLVM 不靠 CPU 型号自动推断后端，而是靠 Triple 字符串精确匹配。哪怕你在 x86_64 机器上跑，传 "armv7-unknown-linux-gnueabihf" 也必须确保 ARM 后端已注册，否则 TargetRegistry::lookupTarget 直接返回空。
典型使用场景：
- 交叉编译：用
llc -mtriple=thumbv7m-none-eabi生成 Cortex-M 代码，前提是InitializeNativeTargetARM()已调用 - JIT 场景：构造
TargetMachine前，先用TargetRegistry::lookupTarget(triple, error)检查是否可用 - 自定义后端：新后端代码放在
llvm/lib/Target/YourTarget/，但必须在 CMake 中启用LLVM_TARGETS_TO_BUILD，且注册函数被链接进最终二进制
容易踩的坑：
- 只调用
InitializeNativeTarget()，但没启用对应后端（比如构建时禁用了 ARM）→ 查不到 target - Triple 写错，如把
aarch64写成arm64（LLVM 内部只认aarch64）→ lookup 失败 - 多线程环境下，
InitializeNativeTarget()只需调用一次，重复调用无害但没必要
TargetMachine 创建前要确认 Target 和 TargetOptions
TargetMachine 是代码生成的实际执行者，但它本身不负责注册目标——那是 InitializeNativeTarget* 的事。如果你跳过初始化就直接 new TargetMachine，构造函数可能静默失败或触发断言。
参数差异关键点：
-
Reloc::Model：决定重定位方式，JIT 通常用Reloc::Model::PIC_，静态链接可用Reloc::Model::Static -
CodeModel::Model：影响地址空间布局，CodeModel::Small适合大多数情况，Large用于 >2GB 代码段 -
CodeGenOpt::Level：控制优化激进程度，None/Less/Default/Aggressive，JIT 常用Default
示例片段（安全写法）：
InitializeNativeTarget();
InitializeNativeTargetX86(); // 显式加，避免隐式依赖
std::string Error;
const Target* TheTarget = TargetRegistry::lookupTarget("x86_64-pc-linux-gnu", Error);
if (!TheTarget) { /* handle */ }
TargetMachine *TM = TheTarget->createTargetMachine(
"x86_64-pc-linux-gnu", "generic", "", TargetOptions(),
Reloc::PIC_, CodeModel::Small, CodeGenOpt::Default);
自定义后端注册失败的三个检查点
如果你在 llvm/lib/Target/MyTarget/ 下写了新后端，但 llc -march=mytarget 报错“unknown target”，问题几乎一定出在这三处：
- CMakeLists.txt 里没把
MyTarget加入add_llvm_target调用，导致源文件根本没编译进libLLVM.so - 没实现
LLVMInitializeMyTargetTargetInfo、LLVMInitializeMyTargetTargetMC、LLVMInitializeMyTargetTarget这三个注册函数，或没在InitializeNativeTarget()中调用它们 -
TargetRegistry::lookupTarget("mytarget-unknown-unknown", ...)传的 triple 名字和后端注册时用的字符串不一致（比如注册用"mytarget"，但 lookup 传"mycpu"）
复杂点在于：这些注册函数默认是 weak symbol，链接器可能悄悄丢掉——务必检查最终二进制里是否存在对应符号（nm -C libLLVM.so | grep MyTarget）。最容易被忽略的是 CMake 配置和 symbol visibility 设置。
