C++判断文件名是否符合POSIX跨平台命名标准

为何 std::filesystem::portable_posix_name() 不足以应对跨平台场景

该函数仅检查POSIX层面的字节级规则：文件名长度不超过255字节、不含 / 和空字符 \0、排除ASCII控制字符（\x00–\x1F、\x7F），且不以 . 或 .. 开头。然而，它完全忽略了Windows系统的诸多禁止项：

• 不会拒绝 :、*、?、"、<、>、| —— 这些字符在Windows中会直接导致 CreateFile 调用失败
• 不拦截 CON、PRN、COM1 等保留名称。即便传入 "CON.txt"，函数也会返回 true
• 允许以 - 开头（例如 -file），但某些Shell工具可能将其误判为命令行参数

跨平台文件名校验必须进行组合判断

要得到一个在Linux/macOS与Windows上都能安全创建的文件字符串，必须同时满足两种系统的约束。推荐做法如下：

bool is_cross_platform_filename(const std::string& s) {
    if (s.empty()) return false;
    return std::filesystem::portable_posix_name(s) &&
           std::filesystem::windows_name(s);
}

这里有几个关键点需要特别注意：

• std::filesystem::windows_name() 是C++17引入的配套函数，它既检查Windows禁止字符，也会判定是否为保留名称（如 CON、LPT9）
• 两个函数的输入必须是 std::string。若传入 const char* 会导致编译错误，需显式转换为 std::string，或使用 std::filesystem::path(s).filename().string() 提取纯文件名
• 如果项目需要兼容C++14及更早的编译器，则需手写等效逻辑：先过滤9个Windows禁止字符 + / + \0，再检查保留名称表，最后补充POSIX的控制字符与长度校验

常见误操作与边界陷阱

实际开发中最容易犯错的地方包括：

• 直接将路径字符串传给 portable_posix_name() —— 该函数只接受“文件名”，不含 / 或 \。若原始输入是 "dir/file:name.txt"，必须先用 std::filesystem::path(str).filename().string() 提取最后一个部分
• 忽略大小写的敏感性：std::filesystem::windows_name() 内部对保留名称进行不区分大小写的匹配；而自行实现时若使用 std::unordered_set 存放 "CON"，则需在比较前统一转为大写（例如用 std::transform + std::toupper）
• UTF-8多字节字符是安全的（例如 "测试.txt" 在Linux/macOS和Windows上都合法），但切勿用 isalnum() 遍历单字节来判断——它会将每个汉字拆成三次调用，每次返回 false
• 空格与点号（.）本身是合法字符，但开头或结尾的点、连续点（如 ".git" 合法，".." 被 portable_posix_name() 显式拒绝，"..." 却允许）需要在业务层额外加以限制

最后牢记一条原则：所谓“跨平台安全”本质上就是向最严格的平台（Windows）看齐。POSIX带来的宽松性反而成为干扰，不要试图兼容所有理论上的可能性，只需遵守两套规则的交集即可。