std::filesystem::portable_posix_name()是C++17提供的最可靠POSIX文件名检查函数，它按字节校验长度≤255、不含NUL/斜杠/控制字符（\x00–\x1F、\x7F）、不以.或..开头，支持UTF-8多字节字符，但不检查Windows保留名或路径存在性。
直接用 std::filesystem::portable_posix_name() —— 这是 C++17 提供的最可靠方式，不用自己遍历字符或写正则。
为什么不能只检查 ASCII 字符和长度
POSIX 允许 UTF-8 编码的任意可打印字符（比如中文、emoji），只要不包含 /、\0 或控制字符。手动用 isalnum() 会把多字节 UTF-8 字符拆开误判；比如一个汉字占 3 字节，但它是单个合法字符。portable_posix_name() 内部按字节处理，符合 POSIX 对“名字”的宽松定义：仅排除 NUL、/、ASCII 控制符（\x00–\x1F 和 \x7F）。
常见错误现象："文件名.txt" 被手写逻辑当成非法（因 isalnum('文') == false），但实际在 Linux/macOS 上完全合法。
std::filesystem::portable_posix_name() 的真实校验范围
它检查的是名字本身是否可安全用作 POSIX 文件系统中的文件名（如 ext4、APFS），不是全量 POSIX 标准验证。具体包括：
立即学习“C++免费学习笔记（深入）”；
- 长度 ≤ 255 字节（不是字符数）
- 不含
\0、/ - 不以
.或..开头（注意：不是禁止含.，而是禁止名字等于或以这两个字符串开头） - 不含 ASCII 控制字符（
\x00–\x1F、\x7F）
它**不检查** Windows 保留名（如 CON、COM1），也不管路径是否存在、权限如何、是否已占用。
输入必须是 std::string 或能隐式转为 std::filesystem::path 的类型；传 const char* 会编译失败。
跨平台项目怎么用才不出错
如果你的程序要同时跑在 Windows 和 Linux/macOS 上，别只靠 portable_posix_name() —— 它在 Windows 下不拦截 :、*、? 等非法字符。
正确做法是组合判断：
- Windows 下需额外调用
std::filesystem::windows_name()或自定义函数（如知识库里的is_valid_win_filename()） - 跨平台统一校验应写成：
std::filesystem::portable_posix_name(s) && std::filesystem::windows_name(s) - 注意：
portable_posix_name()比两者都严格（例如禁止以-开头），别把它当成“通用安全名”——它本质是为最大兼容性设计的子集
最后提醒：这个函数只校验名字，不校验整个路径。如果要判断路径字符串是否合法相对路径，得用 std::filesystem::path(str).is_relative() 单独处理。
