CMAKE_SYSTEM_NAME 表示目标系统（如 Android），CMAKE_HOST_SYSTEM_NAME 才表示构建主机（如 Linux）；混淆二者是交叉编译配置错误主因，正确判断需组合使用四组变量，且 toolchain 中须显式设置 CMAKE_SYSTEM_VERSION。
CMAKE_SYSTEM_NAME 表示目标平台（即程序最终运行的系统），CMAKE_HOST_SYSTEM_NAME 才表示构建主机（即你正在敲命令、跑 cmake 的那台机器）。混淆这两个变量是交叉编译中最常导致配置错乱的根源。
为什么 CMAKE_SYSTEM_NAME 不是你正在用的系统？
因为它的设计语义就是“目标系统”，不是“当前系统”。哪怕你在 Ubuntu 上执行 cmake -DCMAKE_TOOLCHAIN_FILE=android-ndk.cmake，CMAKE_SYSTEM_NAME 的值也是 "Android"，不是 "Linux"。CMake 在读取 toolchain 文件时会主动覆盖该变量——这是它识别交叉编译意图的关键机制。
常见错误现象：
- 在条件块里用
CMAKE_SYSTEM_NAME STREQUAL "Linux"判断是否本地编译，结果交叉编译时整个分支被跳过，Linux 专用的头路径、宏定义、链接选项全丢了 - 误以为
CMAKE_SYSTEM_PROCESSOR是构建机 CPU，其实它对应目标机架构（比如"aarch64"指生成的二进制要跑在 ARM64 设备上）
CMake 提供的四组关键系统变量对照表
记住这四个变量的组合，比死记硬背更可靠：
-
CMAKE_HOST_SYSTEM_NAME：构建机操作系统名，如"Linux"、"Windows"、"Darwin" -
CMAKE_SYSTEM_NAME：目标机操作系统名，如"Android"、"QNX"、"Generic"（裸机常用） -
CMAKE_HOST_SYSTEM_PROCESSOR：构建机 CPU 架构，如"x86_64" -
CMAKE_SYSTEM_PROCESSOR：目标机 CPU 架构，如"armv7-a"、"riscv64"
注意：CMAKE_SYSTEM 和 CMAKE_HOST_SYSTEM 是完整字符串（含内核版本），一般不用来判断，只用于日志或调试输出。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
实际判断逻辑怎么写才安全？
不要只靠一个变量做分支，优先组合使用：
- 判断是否为交叉编译：用
CMAKE_HOST_SYSTEM_NAME STREQUAL CMAKE_SYSTEM_NAME。不等就是交叉（最稳判据） - 判断目标是 Android：用
CMAKE_SYSTEM_NAME STREQUAL "Android"，别加AND CMAKE_SYSTEM_PROCESSOR MATCHES "arm"——NDK 工具链已确保架构匹配，多加反而容易漏掉aarch64或x86_64Android 模拟器场景 - 为主机环境加调试工具：比如在 Linux 主机构建时启用
ccache，应写成if(CMAKE_HOST_SYSTEM_NAME STREQUAL "Linux")，而不是查CMAKE_SYSTEM_NAME
示例片段：
if(CMAKE_HOST_SYSTEM_NAME STREQUAL "Linux")
# 主机是 Linux，可以放心用 ccache、pkg-config 等
find_program(CCACHE_PROGRAM ccache)
if(CCACHE_PROGRAM)
set_property(GLOBAL PROPERTY RULE_LAUNCH_COMPILE "${CCACHE_PROGRAM}")
endif()
endif()
<p>if(CMAKE_SYSTEM_NAME STREQUAL "Android")</p><h1>目标是 Android，设置 NDK 特有宏和链接规则</h1><p>add_compile_definitions(ANDROID;<strong>ANDROID</strong>)
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--gc-sections")
endif()toolchain 文件里最容易忽略的一点
很多自定义 toolchain 文件只设置了 CMAKE_SYSTEM_NAME 和编译器路径，却忘了显式设置 CMAKE_SYSTEM_VERSION。这会导致某些依赖 find_package 的模块（比如 Threads、ZLIB）内部判断失准，转而尝试调用主机系统的 pkg-config 或头文件探测逻辑，最终链接失败。正确做法是在 toolchain 文件开头就补上：
set(CMAKE_SYSTEM_NAME "Android") set(CMAKE_SYSTEM_VERSION "21") # 对应 Android API level set(CMAKE_SYSTEM_PROCESSOR "aarch64")
这个 CMAKE_SYSTEM_VERSION 值必须和你实际链接的 NDK sysroot 一致，否则 find_path 可能找不到 sys/types.h 这类基础头文件。
