必须显式指定目标三元组和构建模式，否则默认只生成x86_64主机库，缺失RISC-V内建函数（如__mulsi3）；因compiler-rt含架构强绑定的builtins、sanitizer等，需用Clang配合riscv64-unknown-elf triple及DCOMPILER_RT_BUILTINS_ARCHS="riscv64"等参数重新编译。
直接编译 compiler-rt 为 RISC-V 目标，必须显式指定目标三元组和运行时构建模式，否则默认只生成 host（通常是 x86_64）的库，且不包含 RISC-V 所需的内建函数（如 __mulsi3、__clzsi2、__udivmodti4 等）。
为什么 compiler-rt 需要单独为 RISC-V 构建
compiler-rt 不是通用静态库，它包含大量与目标架构强绑定的内建函数（builtins）、sanitizer 运行时（ASan/UBSan）、profile 支持等。RISC-V 的指令集特性（如无原生乘除指令的 rv32i、clz 指令依赖扩展、__int128 软实现）决定了其 builtins 必须用对应目标的汇编或 C 代码重新编译。Clang 在生成 RISC-V 代码时会隐式链接 libclang_rt.builtins-riscv32.a 或 libclang_rt.builtins-riscv64.a，如果没构建出来，链接阶段就会报 undefined reference to '__mulsi3'。
cmake 构建时必须传的关键参数
在调用 cmake 配置 compiler-rt 时，以下参数缺一不可：
-
-DCMAKE_C_COMPILER=clang：必须用 Clang（不是 GCC），因为compiler-rt内建函数依赖 Clang 的 builtin 识别和 target attribute -
-DCMAKE_C_COMPILER_TARGET=riscv64-unknown-elf（或riscv32-unknown-elf）：明确告诉 Clang 输出目标 ABI 和指令集，这是生成正确 builtins 的前提 -
-DCOMPILER_RT_DEFAULT_TARGET_TRIPLE=riscv64-unknown-elf：确保 runtime 库名、路径、符号前缀与目标一致 -
-DCOMPILER_RT_BUILTINS_ARCHS="riscv64"（或"riscv32"）：显式启用对应架构的 builtins 子目录构建（否则默认为空） -
-DCMAKE_BUILD_TYPE=Release：debug 构建会引入额外符号和检查，影响嵌入式部署
示例命令（假设源码在 llvm-project/compiler-rt）：
cd build-compiler-rt-rv64 cmake -G Ninja \ -DCMAKE_BUILD_TYPE=Release \ -DCMAKE_C_COMPILER=clang \ -DCMAKE_C_COMPILER_TARGET=riscv64-unknown-elf \ -DCOMPILER_RT_DEFAULT_TARGET_TRIPLE=riscv64-unknown-elf \ -DCOMPILER_RT_BUILTINS_ARCHS="riscv64" \ -DLLVM_CONFIG_PATH=/path/to/llvm-build/bin/llvm-config \ ../llvm-project/compiler-rt
常见链接失败与对应修复点
即使 cmake 成功，链接时仍可能失败，典型现象和原因如下：
-
undefined reference to '__fixdfsi'：未启用浮点 builtins。需确认 RISC-V 目标是否含f扩展，并在 triple 中体现（如riscv64-unknown-elf默认不含，应改用riscv64-unknown-elf-gcc或显式加-march=rv64gcf）。但注意：compiler-rt构建本身不解析-march，它只认 triple 和BUILTINS_ARCHS - 生成的库文件名是
libclang_rt.builtins-x86_64.a：说明COMPILER_RT_DEFAULT_TARGET_TRIPLE没生效，或llvm-config返回了错误的 host triple。务必用llvm-config --host-target核对 -
error: unknown target CPU 'generic-rv64'：Clang 版本太旧（
如何验证 builtins 库已正确生成
构建完成后，检查输出目录中是否存在对应架构的 archive 文件：
ls lib/riscv64/clang/*/lib/linux/libclang_rt.builtins-riscv64.a
用 llvm-ar -t 查看内容，应包含大量 __* 符号：
llvm-ar -t lib/riscv64/clang/*/lib/linux/libclang_rt.builtins-riscv64.a | grep __mul
若输出类似 __mulsi3.o、__muldi3.o，说明 builtins 已就位。Clang 编译 RISC-V 代码时加上 -rtlib=compiler-rt 和 --target=riscv64-unknown-elf 即可自动链接。
RISC-V 的 compiler-rt 构建难点不在代码逻辑，而在于 triple、target、archs 三者必须严格对齐；一旦错一个，生成的库就无法被 Clang 自动发现或链接。实际项目中，建议把 triple 字符串统一定义为变量，在 CMake 和 Clang 命令中复用，避免手误。
