windows上std::filesystem::path传utf-8会失败，因底层调用createfilew需utf-16；linux/macos原生支持utf-8。应显式按平台分别用std::wstring（win）或std::string（其他），避免隐式转换。
Windows 上用 std::filesystem::path 直接传 UTF-8 字符串会失败，Linux/macOS 却能正常工作——这不是 bug，是 Windows API 底层强制要求 UTF-16 路径字符串导致的必然行为。
std::filesystem::path 构造时的编码陷阱
很多人误以为 std::filesystem::path 是“跨平台路径抽象”，其实它只是对底层系统路径表示的封装。构造时传入的 std::string（即 UTF-8）在 Windows 上会被隐式转成 std::wstring，但这个转换依赖当前 locale 设置，而默认 locale 通常不支持 UTF-8 → UTF-16 安全映射。
- 现象：路径含中文时，
std::filesystem::exists("测试.txt")返回false，即使文件真实存在 - 根本原因：Windows 的
CreateFileA等 API 不接受 UTF-8 字节流；std::filesystem在 Windows 实现中调用的是CreateFileW，需要先将输入转为 UTF-16 - 关键点：C++ 标准未规定
std::filesystem::path如何处理多字节字符串，各 STL 实现策略不同（MSVC 用MultiByteToWideChar(CP_ACP)，不是CP_UTF8） - 安全做法：显式构造
std::filesystem::path时，Windows 用std::wstring，其他平台用std::string
跨平台路径构造的推荐写法
不要依赖自动转换，统一用预处理器区分平台，并确保源文件保存为 UTF-8 无 BOM。
- Windows：用
std::wstring+utf8_to_utf16()函数（调用MultiByteToWideChar(CP_UTF8, ...)） - Linux/macOS：直接用
std::string，UTF-8 原生支持 - 示例：
#ifdef _WIN32
std::wstring wpath = utf8_to_utf16(u8"数据/用户_张三.json");
std::filesystem::path p(wpath);
#else
std::filesystem::path p(u8"数据/用户_张三.json");
#endif
- 注意：
u8"..."字面量类型是const char8_t[]，需显式转std::string或std::wstring，不能直接传给 Windows 版std::filesystem::path构造函数
第三方库替代方案：ICU 或 utf8cpp 的轻量级选择
若不想手写 utf8_to_utf16，可用成熟小库规避平台细节。
-
utf8cpp：头文件仅依赖，提供utf8::utf8to16()，返回std::u16string，再转std::wstring（Windows 下） -
ICU：重型但完备，icu::UnicodeString::fromUTF8()+.toUTF16()，适合已有 ICU 依赖的项目 - 避免用
std::codecvt_utf8_utf16：C++20 已弃用，且 MSVC 实现有已知 bug，无法正确处理 BMP 外字符（如 emoji） - 性能提示：路径构造是低频操作，优先选安全而非极致性能；
utf8cpp::unchecked可跳过验证提速，但仅限可信输入（如硬编码资源路径）
std::filesystem::path 的隐式转换风险
看似方便的隐式构造（如 std::filesystem::path p = u8"中文.txt"）在 Windows 上极易失效，尤其当程序未设置控制台代码页或链接了静态 CRT 时。
- 常见错误：在 VS 调试器中看到路径显示为乱码，
p.string()输出异常字节序列 - 调试技巧：用
p.native()查看底层存储格式（Windows 返回std::wstring，Linux 返回std::string），确认是否真为 UTF-16 - 真正跨平台的安全边界：所有含非 ASCII 字符的路径，必须经过显式 UTF-8 ↔ UTF-16 转换，且该转换逻辑应封装在统一工具函数中，不可散落各处
最易被忽略的一点：即使路径构造成功，std::filesystem::directory_iterator 返回的 path 对象，在 Windows 上其 string() 方法仍可能返回损坏的 UTF-8（因内部从 UTF-16 回转时用了错误 code page）。务必用 native() 或提前转回 UTF-8 再处理文件名。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
