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默认以文本模式打开，遇到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") 一定存在、信号处理行为一致。这些地方没标准兜底，得靠实际平台验证，不能只看编译过不过。
