跨平台测试策略：Windows/Linux/macOS差异处理

说实话，跨平台测试这个话题，我踩过的坑比写过的代码还多。记得刚入行那会儿，我在Windows上写了个单元测试，跑得妥妥的。结果同事在Linux上一编译，直接崩了。原因？就一个路径分隔符的问题。从那以后，我就养成了一个习惯——写测试代码时，脑子里要同时装着三个操作系统。

今天咱们就来聊聊，怎么用CMake+CTest把这套跨平台测试策略落地。说白了，就是让同一套测试代码，在Windows、Linux、macOS上都能跑，而且跑得对。

1. 平台差异到底差在哪？

你想想看，三个系统在底层就有本质区别。我列个表，你一看就明白：

差异项	Windows	Linux	macOS
路径分隔符	\	/	/
换行符	\r\n	\n	\n
动态库后缀	.dll	.so	.dylib
默认编码	GBK/UTF-16	UTF-8	UTF-8
线程模型	Windows Thread	POSIX Thread	POSIX Thread

这些差异，在测试代码里如果不处理，轻则测试失败，重则编译都过不去。我个人习惯是：在CMake层面就把差异隔离掉，测试代码里尽量少写平台判断。

2. 条件编译：CMake里的平台判断

CMake提供了几个内置变量，用来判断当前平台。我最常用的是这三个：

• WIN32：Windows系统（包括32位和64位）
• UNIX：Linux和macOS都算
• APPLE：仅macOS

来看一个实际例子。假设我们要测试文件读写，不同平台的路径写法不一样：

# CMakeLists.txt
if(WIN32)
    target_compile_definitions(test_fileio PRIVATE PLATFORM_WINDOWS)
elseif(APPLE)
    target_compile_definitions(test_fileio PRIVATE PLATFORM_MACOS)
else()
    target_compile_definitions(test_fileio PRIVATE PLATFORM_LINUX)
endif()

然后在测试代码里：

// test_fileio.cpp
#ifdef PLATFORM_WINDOWS
    const char* test_path = "C:\\temp\\test.txt";
#elif defined(PLATFORM_MACOS)
    const char* test_path = "/tmp/test.txt";
#else
    const char* test_path = "/tmp/test.txt";
#endif

TEST(FileIOTest, WriteAndRead) {
    // 测试逻辑...
}

嗯，这里要注意：别在测试代码里写太多平台判断。我曾经见过一个测试文件，里面#ifdef占了半页，读起来特别痛苦。更好的做法是——把平台差异封装成辅助函数，测试代码只调用统一接口。

3. 平台特定测试：有些测试只该在某个系统上跑

有些测试天然就是平台相关的。比如测试Windows注册表、测试Linux的epoll、测试macOS的Grand Central Dispatch。这些测试在其他平台上根本跑不了，强行跑只会报错。

我的做法是：用CMake的标签机制，给测试打上平台标签。

# CMakeLists.txt
add_test(NAME test_registry COMMAND test_registry)
set_tests_properties(test_registry PROPERTIES LABELS "windows")

add_test(NAME test_epoll COMMAND test_epoll)
set_tests_properties(test_epoll PROPERTIES LABELS "linux")

add_test(NAME test_gcd COMMAND test_gcd)
set_tests_properties(test_gcd PROPERTIES LABELS "macos")

然后在运行测试时，只跑当前平台相关的：

# Windows上
ctest -L "windows"

# Linux上
ctest -L "linux"

# macOS上
ctest -L "macos"

如果你用的是CI/CD流水线，可以在不同平台的配置里分别指定标签。这样既保证了测试覆盖率，又不会因为平台不兼容而报错。

4. 跨平台测试的避坑指南

我曾经在一个项目里，测试代码里用了Sleep(1000)，Windows上没问题。结果移植到Linux上一编译，报错——Linux里是sleep(1)，单位是秒。这种细节特别容易翻车。

我总结了几条经验：

• 路径处理用CMake变量：比如${CMAKE_CURRENT_SOURCE_DIR}，别硬编码路径
• 换行符统一处理：测试文本文件时，先做换行符归一化
• 动态库加载：用dlopen（Linux/macOS）和LoadLibrary（Windows）时，封装成统一接口
• 编码问题：测试字符串时，明确指定UTF-8编码，避免Windows默认GBK的坑

5. 用SVG梳理跨平台测试策略

下面这张图，是我自己总结的跨平台测试策略流程。你可以把它当作一个检查清单：

这张图的逻辑很简单：先识别平台，再定义编译宏，最后用标签过滤测试。每一步都做对了，跨平台测试就不会出大问题。

6. 实战：一个跨平台测试的完整例子

最后，我给你看一个完整的CMakeLists.txt配置。这个配置我用了好几年，基本没出过问题：

cmake_minimum_required(VERSION 3.16)
project(CrossPlatformTest LANGUAGES CXX)

enable_testing()

# 添加测试可执行文件
add_executable(test_cross test_cross.cpp)

# 平台特定编译选项
if(WIN32)
    target_compile_definitions(test_cross PRIVATE PLATFORM_WINDOWS)
    target_link_libraries(test_cross PRIVATE ws2_32)
elseif(APPLE)
    target_compile_definitions(test_cross PRIVATE PLATFORM_MACOS)
    find_library(COREFOUNDATION CoreFoundation)
    target_link_libraries(test_cross PRIVATE ${COREFOUNDATION})
else()
    target_compile_definitions(test_cross PRIVATE PLATFORM_LINUX)
    target_link_libraries(test_cross PRIVATE pthread)
endif()

# 注册测试并打标签
add_test(NAME test_cross COMMAND test_cross)
set_tests_properties(test_cross PROPERTIES LABELS "${CMAKE_SYSTEM_NAME}")

# 平台特定测试
if(WIN32)
    add_executable(test_registry test_registry.cpp)
    add_test(NAME test_registry COMMAND test_registry)
    set_tests_properties(test_registry PROPERTIES LABELS "windows")
endif()

if(UNIX AND NOT APPLE)
    add_executable(test_epoll test_epoll.cpp)
    add_test(NAME test_epoll COMMAND test_epoll)
    set_tests_properties(test_epoll PROPERTIES LABELS "linux")
endif()

好了，跨平台测试策略就聊到这儿。核心就一句话：在CMake层面隔离差异，在测试代码里保持统一。你按这个思路去写，基本不会翻车。

---

公众号:蓝海资料掘金营，微信deep3321