C++怎么跨平台 C++编写跨平台代码注意事项【指南】

std::Filesystem 可替代 boost::filesystem 或手写路径拼接实现跨平台路径处理，自动归一化分隔符、统一 exists() 行为，并支持 .String() 与 .generic_string() 输出适配格式；需注意旧编译器兼容性及二进制 i/o 的 std::ios::binary 标志。

用 std::filesystem 代替 boost::filesystem 或手写路径拼接

跨平台最常崩在路径分隔符和文件操作上。windows 用反斜杠 ，linux/macos 用正斜杠 /，硬拼字符串或用 #ifdef _WIN32 切换逻辑，后期维护成本高、易漏。

从 c++17 开始，std::filesystem 原生支持路径标准化：构造时自动归一化分隔符，.string() 输出当前平台格式，.generic_string() 强制返回正斜杠（适合网络路径或配置输出）。

• 别再用 str.replace("", "/") 或条件宏处理路径拼接
• 注意 macOS 和 Linux 对大小写不敏感但默认区分，Windows 默认不区分——std::filesystem::exists() 行为一致，但语义上仍需按目标平台约定命名
• 某些嵌入式或旧编译器（如 GCC 8.2 以下、MSVC 2015）未完整实现 std::filesystem，需检查 __cpp_lib_filesystem 宏或降级用 absl::StrCat + 手动分隔符（仅临时方案）

std::filesystem::path p = "data" / "config.json"; // 自动适配分隔符 if (std::filesystem::exists(p)) {     std::ifstream f(p); // 直接传 path，无需 .string() }

避免直接调用 CreateFile、open() 等系统 API

裸调系统调用等于主动放弃跨平台能力。哪怕只差一个参数（比如 Windows 的 CREATE_ALWAYS vs Linux 的 O_CREAT | O_WRONLY），后续就得补一堆 #ifdef 和错误码映射。

标准库已覆盖绝大多数场景：std::fstream 处理文件读写，std::Thread 替代 pthread_create / CreateThread，std::chrono 统一时钟精度。

立即学习“C++免费学习笔记（深入）”；

• 需要异步 I/O？先确认是否真绕不开——多数业务层用线程池 + 同步读写更稳，也更容易测试
• 要用 socket？优先选 Boost.Asio 或 libuv，而不是自己封装 socket() / WSAStartup()
• Windows 上 std::ofstream 默认以文本模式打开，遇到 自动转换；Linux 不转换。若需二进制一致性，务必加 std::ios::binary 标志

字符编码别碰 char* 和本地 locale

Windows 控制台默认 ANSI 编码（如 GBK/CP1252），Linux/macOS 终端默认 UTF-8，用 std::cout 在不同平台输出乱码是常态。根源在于 <code>char 类型不携带编码信息，且 std::locale 在各平台实现差异大、不可靠。

• 所有外部输入/输出（文件、网络、命令行参数）统一用 std::u8string（C++20）或 std::string 存 UTF-8 字节流，内部处理时转 std::u32string（如需 Unicode 拆分）
• Windows 下获取命令行参数必须用 GetCommandLineW() + WideCharToMultiByte(CP_UTF8)，不能依赖 main(int, char**) 的 argv
• 第三方库（如 SQLite、cURL）若要求宽字符接口，优先启用其 UTF-8 模式（如 sqlite3_open_v2 第二个参数用 UTF-8 路径），而非强转 wchar_t*

构建系统别写死 cl.exe 或 gcc 路径

手动写 Makefile 或脚本调用编译器，等于把平台耦合写进构建流程。CMake 是事实标准，但常见错误是滥用 find_program 查 gcc，或在 CMakeLists.txt 里硬写 add_definitions(-D_WIN32)。

• 用 target_compile_definitions(mylib PRIVATE $<windows>)</windows> 让 CMake 自动注入平台宏
• 检测功能而非编译器：check_cxx_source_compiles 测 std::filesystem 可用性，比判断 CMAKE_CXX_COMPILER_ID MATCHES "Clang" 更可靠
• 交叉编译时，别改源码去适配——用 toolchain 文件指定 CMAKE_SYSTEM_NAME 和 CMAKE_FIND_ROOT_PATH，让 find_package 自动找对路径

真正难的不是语法兼容，而是运行时环境假设：比如认为 /tmp 一定可写、getenv("HOME") 一定存在、信号处理行为一致。这些地方没标准兜底，得靠实际平台验证，不能只看编译过不过。