必须使用工具链文件才能正确实现clang交叉编译；仅设置cmake_c_compiler无效，因cmake仍按宿主机推导系统与架构，导致头文件、库路径及链接全错，需在工具链文件中显式设定cmake_system_name、cmake_system_processor、--target参数、cmake_linker为lld，并强制build_shared_libs=off。
Clang交叉编译必须用工具链文件，不能只靠-DCMAKE_C_COMPILER
只在命令行传-DCMAKE_C_COMPILER=clang或在CMakeLists.txt里set(CMAKE_CXX_COMPILER clang++)，CMake仍会按宿主机系统推导CMAKE_SYSTEM_NAME和CMAKE_SYSTEM_PROCESSOR，导致头文件路径、库搜索逻辑全错。真正起作用的是工具链文件（Toolchain File），它强制覆盖整个目标环境认知。
工具链文件本质是一个.cmake脚本，需显式设置：
-
CMAKE_SYSTEM_NAME：如Linux、Windows、Generic（裸机） -
CMAKE_SYSTEM_PROCESSOR：如aarch64、arm、riscv64 -
CMAKE_C_COMPILER和CMAKE_CXX_COMPILER：必须是完整路径，例如/opt/llvm/bin/clang -
CMAKE_SYSROOT：指向目标平台的sysroot（含usr/include和usr/lib） -
CMAKE_FIND_ROOT_PATH：设为${CMAKE_SYSROOT}，并配合CMAKE_FIND_ROOT_PATH_MODE_*限制查找范围
clang --target参数必须透传到CMake编译命令中
Clang靠--target三元组（如aarch64-unknown-linux-gnu）决定ABI、默认标准库、内建宏等。CMake不会自动把CMAKE_SYSTEM_NAME转成--target，必须手动加进编译选项。
正确做法是在工具链文件末尾加：
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} --target=aarch64-unknown-linux-gnu --sysroot=${CMAKE_SYSROOT}")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} --target=aarch64-unknown-linux-gnu --sysroot=${CMAKE_SYSROOT}")
漏掉--target会导致：
- 生成x86_64指令却链接ARM库，链接时报
file not recognized: file format not recognized -
sizeof(void*)仍是8但实际目标是4，结构体对齐出错 -
__linux__宏未定义，条件编译失效
链接器必须显式指定lld，且CMAKE_LINKER不能省略
Clang默认调用系统ld，而多数交叉场景下宿主机ld不支持目标平台格式（比如x86_64 host上用ld链接ARM ELF会失败）。Clang配套的lld是真正跨架构的链接器。
在工具链文件中必须写：
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
set(CMAKE_LINKER "/opt/llvm/bin/lld") set(CMAKE_CXX_LINK_EXECUTABLE "<cmake_linker><flags><cmake_cxx_link_flags><link_flags><objects> -o <target><link_libraries>") </link_libraries></target></objects></link_flags></cmake_cxx_link_flags></flags></cmake_linker>
常见错误：
- 只设
-fuse-ld=lld在CMAKE_CXX_FLAGS里——这仅影响编译阶段，链接阶段仍走默认ld - 没重写
CMAKE_CXX_LINK_EXECUTABLE——CMake生成的Ninja/Makefile仍调用ld -
lld路径不对，或版本太老不支持--sysroot（需LLVM 12+）
静态库项目要防BUILD_SHARED_LIBS污染
交叉编译时若全局设了-DBUILD_SHARED_LIBS=ON，所有未显式声明类型的add_library都会变成动态库——但目标平台可能根本没有libdl.so或动态加载能力，尤其在嵌入式裸机环境。
务必在工具链文件开头加：
set(BUILD_SHARED_LIBS OFF CACHE BOOL "Force static lib generation" FORCE)
同时每个库定义必须带STATIC：
add_library(xlog STATIC xlog.cpp)
target_include_directories(xlog PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)
否则即使file libxlog.a显示current ar archive，实际内容可能是ELF shared object，因为BUILD_SHARED_LIBS优先级高于STATIC关键字。
最易被忽略的是CMAKE_FIND_ROOT_PATH_MODE_PACKAGE——它控制find_package()行为。不设为ONLY时，CMake会先查宿主机/usr/lib/cmake，找到x86_64版OpenSSLConfig.cmake就直接用，导致链接失败却报“undefined reference to SSL_new”。
