最稳妥方案是用if(win32)、if(unix)、if(apple)三层判断，配合cmake_cxx_compiler_id精确识别编译器；避免依赖cmake_system_name，因其在交叉编译时可能失真，而win32/unix/apple由cmake基于目标abi和头文件推导，更可靠。
直接结论：用 if(WIN32)、if(UNIX)、if(APPLE) 三层判断最稳妥，配合 CMAKE_CXX_COMPILER_ID 做编译器微调，别依赖 CMAKE_SYSTEM_NAME 做主分支逻辑。
为什么不能只靠 CMAKE_SYSTEM_NAME 判断平台？
这个变量在交叉编译时可能和实际运行环境不一致（比如在 Linux 上用 Clang 编译 macOS 目标，CMAKE_SYSTEM_NAME 是 Darwin，但宿主是 Linux），而 WIN32/UNIX/APPLE 是 CMake 内置的语义化宏，由构建系统根据目标 ABI 和头文件可用性推导，更可靠。
常见误用现象：if(CMAKE_SYSTEM_NAME STREQUAL "Linux") 在 WSL 或某些容器环境下可能返回 Linux，但项目其实跑在 Windows 子系统里——此时 WIN32 为 FALSE、UNIX 为 TRUE，逻辑就断了。
-
WIN32：覆盖所有 Windows 环境（含 MSVC、Clang-CL、MinGW） -
UNIX：所有类 Unix 系统（Linux、macOS、FreeBSD、WSL），但不含 Cygwin -
APPLE：仅 macOS（它是UNIX的子集，必须放在if(UNIX)内部嵌套）
add_compile_options 和 target_compile_options 该选哪个？
优先用 target_compile_options，它支持作用域控制，避免污染无关目标；add_compile_options 是全局生效，容易在大型项目中引发隐式耦合。
典型错误：在根 CMakeLists.txt 里写 add_compile_options(-Werror)，结果测试用的第三方 mock 库因警告被拦住编译失败。
- 对当前 target 加选项：
target_compile_options(myapp PRIVATE -Wall) - 让依赖者也继承（比如导出头文件里用了
[[nodiscard]]）：target_compile_options(mylib PUBLIC -std=c++17) - 只影响链接时不参与编译（如 LTO）：
target_compile_options(myapp INTERFACE -flto)
Windows 和 Unix 的关键编译选项差异点
不是所有选项都能“翻译”，得按语义等价替换。比如 GCC/Clang 的 -fPIC 在 MSVC 里没有对应项，而是靠 DLL 导出声明或 /LD 链接器标志控制。
常见场景示例：
if(WIN32)
# MSVC 特有：启用安全异常处理、Unicode 支持
target_compile_definitions(myapp PRIVATE _CRT_SECURE_NO_WARNINGS UNICODE _UNICODE)
target_compile_options(myapp PRIVATE /EHsc /MP)
elseif(UNIX)
if(APPLE)
# macOS：隐藏符号、禁用 RTTI（可选）
set_target_properties(myapp PROPERTIES CXX_VISIBILITY_PRESET hidden)
target_compile_options(myapp PRIVATE -fno-rtti)
else()
# Linux：位置无关、标准警告
target_compile_options(myapp PRIVATE -fPIC -Wall -Wextra)
endif()
endif()
-
/EHsc≠-fexceptions：前者是 MSVC 异常模型开关，后者只是 GCC 启用异常支持，漏掉会导致std::thread构造失败 -
-DUNICODE必须配-D_UNICODE（MSVC 要求两者共存） -
-fPIC在 Windows 上不报错但无效，硬加可能触发 MinGW 的奇怪链接行为
容易被忽略的陷阱：编译器 ID 匹配要加边界
CMAKE_CXX_COMPILER_ID MATCHES "GNU" 会同时匹配 GNU 和 Clang（因为 Clang 声称兼容 GCC），导致 Clang 被误判为 GCC 并套用 -march=native——这在 macOS 上可能崩溃。
正确写法：
if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") target_compile_options(myapp PRIVATE /O2) elseif(CMAKE_CXX_COMPILER_ID STREQUAL "Clang") target_compile_options(myapp PRIVATE -O3 -flto=thin) elseif(CMAKE_CXX_COMPILER_ID STREQUAL "GNU") target_compile_options(myapp PRIVATE -O3 -march=native) endif()
- 永远用
STREQUAL而非MATCHES做编译器精确识别 -
Clang在 Windows 上可能用Clang-CL模式，此时CMAKE_CXX_COMPILER_ID是Clang，但命令行参数风格接近 MSVC，需额外检查CMAKE_CXX_SIMULATE_ID - ARM 平台交叉编译时，
CMAKE_SYSTEM_PROCESSOR可能是aarch64或armv7l，别假设只有arm开头
最麻烦的其实是混合场景：比如用 Clang 编译 Windows DLL，既要处理 MSVC 的宏定义习惯，又要保留 Clang 的优化特性——这时候得把平台判断和编译器判断拆成正交条件，而不是嵌套一层套一层。
