必须用cmake预定义布尔变量（win32、apple）或cmake_system_name字符串匹配来精准区分windows、macos、linux平台，避免逻辑重叠；再据此注入宏定义、设置编译选项、链接对应系统库。
要在CMakeLists.txt中让同一份构建脚本在Windows、Linux和macOS上自动适配不同平台的编译选项、头文件路径、链接库和宏定义，必须用对条件判断的变量和语法——写错一个字母或混淆CMAKE_SYSTEM_NAME与WIN32，就会导致Linux下链接ws2_32.lib或macOS里调用pthread_create失败。
用内置布尔变量快速区分三大平台
第一步：直接使用CMake预定义的平台布尔变量，这是最简洁、最常用的方式。
if(WIN32) → 仅匹配Windows（包括32位和64位），【注意：它不匹配Cygwin或MSYS2环境，这些属于UNIX】
elseif(APPLE AND NOT WIN32) → 精准捕获macOS（排除了Apple TV OS等其他Apple平台，且避免与WIN32重叠）
else() → 剩余所有情况归为Linux及其他Unix-like系统（如FreeBSD、OpenBSD），但【不要写成elseif(UNIX)，因为UNIX在CMake中为真时也包含APPLE，会造成逻辑重叠】
用CMAKE_SYSTEM_NAME做精确匹配
当需要区分更细粒度的系统类型（比如Linux vs FreeBSD）、或项目明确要求避免隐式继承逻辑时，应使用CMAKE_SYSTEM_NAME字符串匹配。
第一步：检查CMAKE_SYSTEM_NAME值，它由CMake在配置阶段自动设置，稳定可靠。
第二步：用MATCHES进行正则匹配，比STREQUAL更灵活，可应对不同版本命名变体：
if(CMAKE_SYSTEM_NAME MATCHES "Windows") → 匹配"Windows"、"WindowsStore"等
elseif(CMAKE_SYSTEM_NAME MATCHES "Linux") → 专指Linux内核系统，不含macOS
elseif(CMAKE_SYSTEM_NAME MATCHES "Darwin") → macOS底层内核名，比APPLE更底层、更唯一
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
这一步操作起来很简单，直接把文件拖进去就行。但要注意：CMAKE_SYSTEM_NAME在交叉编译时反映的是目标系统，不是宿主系统——如果你在Linux上交叉编译Windows程序，它的值就是"Windows"。
平台专属宏定义与编译选项注入
方法一：用add_definitions统一注入预处理器宏
if(WIN32)
add_definitions(-DPLATFORM_WINDOWS -D_CRT_SECURE_NO_WARNINGS)
elseif(APPLE)
add_definitions(-DPLATFORM_MACOS -D__MAC_OS_X_VERSION_MAX_ALLOWED=101500)
else()
add_definitions(-DPLATFORM_LINUX -D_GNU_SOURCE)
endif()
方法二：用target_compile_definitions按目标精细化控制（推荐）
target_compile_definitions(myapp PRIVATE $:PLATFORM_WINDOWS>)
target_compile_definitions(myapp PRIVATE $:PLATFORM_MACOS>)
target_compile_definitions(myapp PRIVATE $:$>>>>>:PLATFORM_LINUX>)${apple}>${win32}>${apple}>${win32}>
生成器表达式在这里真正体现价值：它在生成VS工程或Makefile时才展开，确保Debug/Release配置各自获得正确宏，而不是在cmake配置阶段就固化死。
平台相关依赖库自动链接
① 先判断平台，再决定链接哪个系统库：
if(WIN32)
target_link_libraries(myapp PRIVATE ws2_32 iphlpapi)
elseif(APPLE)
find_library(COREFOUNDATION CoreFoundation)
target_link_libraries(myapp PRIVATE ${COREFOUNDATION} Security)
else()
target_link_libraries(myapp PRIVATE pthread dl rt m)
endif()
② 更优雅的做法是用生成器表达式一行写完：
target_link_libraries(myapp PRIVATE
$:ws2_32;iphlpapi>
$:CoreFoundation;Security>
$:pthread;dl;rt;m>)
PLATFORM_ID是CMake 3.22+引入的标准化标识符，比WIN32/APPLE更语义清晰，且支持未来新增平台（如WASI）。若你的CMake版本低于3.22，请改用CMAKE_SYSTEM_NAME匹配。
