跨平台开发核心是代码自动适配平台行为，CMake组织构建并传递平台宏（如_WIN32、__linux__），预处理器统一处理分支逻辑，结合标准宏条件编译、第三方库自动查找与CI多平台验证，实现真正稳定跨平台。
用 C++ 做跨平台开发，核心不是“写一次到处编译”，而是让同一份代码能根据目标平台自动适配行为。CMake 负责组织构建流程，平台宏（如 _WIN32、__linux__、__APPLE__）负责控制逻辑分支——两者配合，才是稳定跨平台的关键。
用 CMake 识别并传递平台信息
CMake 内置变量（如 CMAKE_SYSTEM_NAME）可判断当前构建目标系统。别手动写 if(WIN32) 判断源码里，而应在 CMakeLists.txt 中提前定义宏，让预处理器统一处理：
-
set(CMAKE_CXX_STANDARD 17)统一语言标准，避免编译器差异 -
if(CMAKE_SYSTEM_NAME STREQUAL "Windows")
add_compile_definitions(WIN32_LEAN_AND_MEAN)elseif(CMAKE_SYSTEM_NAME STREQUAL "Linux")
add_compile_definitions(__LINUX__)elseif(CMAKE_SYSTEM_NAME STREQUAL "Darwin")
add_compile_definitions(__MACOS__)endif() - 也可用
target_compile_definitions(myapp PRIVATE ...)按目标粒度设置，更安全
在 C++ 代码中用标准宏做条件编译
优先使用编译器/系统提供的标准宏，而非自定义宏（减少维护成本）。常见组合：
-
#ifdef _WIN32—— Windows（含 MSVC、MinGW、Clang-cl） -
#ifdef __linux__—— Linux（GCC/Clang 默认定义） -
#ifdef __APPLE__—— macOS（同时会定义__MACH__） - 路径分隔符：
#ifdef _WIN32 ? "\\" : "/" - 文件操作差异：Windows 用
CreateFile/CloseHandle，Linux/macOS 用open/close，封装成统一接口时靠宏分发
处理第三方库的跨平台依赖
不同平台常用库路径、链接名、甚至 ABI 都不同。CMake 可帮你自动桥接：
立即学习“C++免费学习笔记（深入）”；
- 用
find_package(OpenSSL REQUIRED)，CMake 会按平台查找对应版本（Windows 查 .lib/.dll，Linux 查 .so，macOS 查 .dylib） - 链接时区分：
if(WIN32) target_link_libraries(app PRIVATE wsock32 ws2_32) endif() - 头文件路径兼容：
include_directories(${CMAKE_CURRENT_SOURCE_DIR}/platform/${CMAKE_SYSTEM_NAME})，按系统加载不同平台适配头
测试与验证不能只靠本地环境
一套代码在 Windows 编译通过 ≠ 跨平台可用。必须在各目标平台真实构建+运行：
- 用 GitHub Actions 或 GitLab CI，配置 Windows / Ubuntu / macOS runner，每次 push 自动构建
- 检查宏是否被正确定义：在 main.cpp 加
#error "Unknown platform"作为兜底 - 避免隐式依赖：比如用
std::filesystem要确认编译器版本和标准库支持（GCC 8+、MSVC 2019+、Clang 10+），必要时降级为 Boost.Filesystem
基本上就这些。CMake 是骨架，宏是神经，真正跨平台的难点不在语法，而在对各平台底层机制（线程模型、IO 行为、字符编码、信号处理）的理解和隔离。写得越“平台无关”，背后平台相关的适配就越扎实。
