c++oding="utf-8" ?>
std::filesystem::portable_posix_name() 是 c++17 提供的 posix 兼容文件名检查函数，验证长度≤255字节、不含nul/斜杠/控制字符、不以.或..开头，不检查windows保留名，仅校验名字合法性。
std::filesystem::portable_posix_name() —— 这是 C++17 <filesystem></filesystem> 里最贴近 POSIX 文件名规范的现成检查函数，不需手写正则或字符遍历。
std::filesystem::portable_posix_name() 是什么
它不是“POSIX 标准原文校验”，而是 Boost 和 libstdc++/libc++ 实现的、广泛接受的 POSIX 兼容性子集：长度 ≤ 255 字节、不含 NUL//<p>它不是“POSIX 标准原文校验”，而是 Boost 和 libstdc++/libc++ 实现的、广泛接受的 POSIX 兼容性子集：长度 ≤ 255 字节、不含 NUL/<code>/\0、不以 . 或 .. 开头、不包含控制字符（\x00–\x1F、\x7F）、不包含 / 和 \0。注意：它**不检查保留名**（如 CON、NUL），那是 Windows 特有逻辑。
. 或 .. 开头、不包含控制字符（\x00–\x1F、\x7F）、不包含 / 和 <p>它不是“POSIX 标准原文校验”，而是 Boost 和 libstdc++/libc++ 实现的、广泛接受的 POSIX 兼容性子集：长度 ≤ 255 字节、不含 NUL/<code>/\0、不以 . 或 .. 开头、不包含控制字符（\x00–\x1F、\x7F）、不包含 / 和 \0。注意：它**不检查保留名**（如 CON、NUL），那是 Windows 特有逻辑。。注意：它**不检查保留名**（如 CON、NUL），那是 Windows 特有逻辑。
- 返回
true表示该字符串可安全用作 POSIX 系统上的文件名（例如 Linux/macOS 的普通文件） - 输入必须是
std::string或能隐式转为std::filesystem::path的类型；传const char*会编译失败 - 它只检查名字本身，不检查路径是否存在、是否已占用、是否有权限
为什么不用手写 isalnum() + 长度判断
因为 POSIX 允许很多非 ASCII 字符（如 UTF-8 编码的中文、emoji），只要它们在文件系统层面合法。单纯遍历字节会误判多字节字符——比如一个 UTF-8 中文字符占 3 字节，但它是单个逻辑字符，portable_posix_name() 内部按字节处理并遵循 POSIX 对“可打印字符”的宽松定义（即排除控制符和斜杠），比手动检查更可靠。
- 手动检查容易漏掉
\x7F（DEL）或高位字节组合（如\xC0\x80这类非法 UTF-8 序列，虽不属 POSIX 范畴，但实际写入会失败） - POSIX 并不要求文件名是 ASCII，只要求不包含
/和 NUL；portable_posix_name()正是按此原则设计 - 如果你硬要兼容老标准（C++14 及以下），只能退回到
std::all_of(s.begin(), s.end(), [](unsigned char c) { return c > 31 && c != 127 && c != '/'; })，但无法处理长度超限或嵌入 NUL 的情况
常见错误：把 portable_posix_name() 当 Windows 合法性检查
这个函数对 Windows 不起作用——它不拒绝 :、*、?、"、、<code>>、|，也不检查 CON 等保留名。Windows 下要用 std::filesystem::windows_name() 或自己实现（参考知识库中 is_valid_win_filename()）。
- 跨平台项目若需统一校验，得组合调用：
std::filesystem::portable_posix_name(s) && std::filesystem::windows_name(s) - 但要注意：
portable_name()比两者都严格（禁止开头为.、-），别误当成“通用安全名”——它其实是为最大兼容性设计的保守子集 - 如果只是给 Linux 工具生成临时文件名，
portable_posix_name()就够了；若要写入 Windows NFS 共享或 WSL，就得额外过滤 Windows 禁用字符
\0 的 std::string（C++ 允许，但 POSIX 文件名不允许）、超长 UTF-8 序列导致字节数超 255。这些 portable_posix_name() 都会正确返回 false，但你得确保传入的是干净的字符串——比如从用户输入读取后没做 trim 或截断。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
