C++如何判断一个文件是否在系统中被标记为隐藏

Windows下用GetFileAttributes检查FILE_ATTRIBUTE_HIDDEN位，必须确保路径有效且文件存在；Linux/macOS没有系统级的隐藏属性，全靠文件名以点号开头的约定来判断，跨平台时只能分支处理。

Windows下用GetFileAttributes检查FILE_ATTRIBUTE_HIDDEN

在Windows上，隐藏属性本身就是文件元数据的一部分，直接通过GetFileAttributes就能拿到，压根不用绕弯子去读注册表或者解析shell属性。返回值是个DWORD，只要里面带了FILE_ATTRIBUTE_HIDDEN这个位，那文件就是被标记为隐藏的。

• 必须传入绝对路径，或者当前目录下的相对路径；路径末尾要是带个\（比如传了个目录路径）就会失败，得确保路径指向的是文件。
• 如果文件压根不存在，GetFileAttributes会返回INVALID_FILE_ATTRIBUTES，做位运算之前必须先判断这个值，否则容易翻车。
• 注意：这个API不识别那些“受保护的操作系统文件”（比如FILE_ATTRIBUTE_SYSTEM），它只响应普通用户手动设置的隐藏属性。
• 典型判断逻辑长这样：

  DWORD attr = GetFileAttributes(L"config.txt");if (attr != INVALID_FILE_ATTRIBUTES && (attr & FILE_ATTRIBUTE_HIDDEN)) {    // 是隐藏文件}

Linux/macOS没有“隐藏文件”系统属性，靠文件名前缀判断

POSIX系统天生就没有隐藏标志位，所谓的“隐藏”不过是shell层面的约定：以.开头的文件名（比如.gitconfig）默认会被ls这类工具忽略。所以C++程序只能自己解析文件名，没法依赖系统API。

• stat()或lstat()返回的st_mode里并不包含隐藏信息，st_file_attributes这个字段在Linux/macOS上压根没定义。
• 判断方法很简单：检查basename的第一个字符是不是'.'。但有个坑——"."和".."是特殊目录项，不能误判成普通隐藏文件。
• 跨平台代码里如果用std::filesystem::path，可以用.filename().string()[0] == '.'来判断，不过得先确认.filename()不为空。

跨平台封装时别混淆语义：隐藏 ≠ 不可见 ≠ 权限受限

很多开发者容易踩的一个误区是：以为“隐藏文件”就代表不可读或者需要提权才能访问。其实完全不是一回事。FILE_ATTRIBUTE_HIDDEN和.dotfile都只影响默认的文件列表行为，open()、read()这些系统调用根本不受限制。

• 权限控制由st_mode（POSIX）或SECURITY_DESCRIPTOR（Windows）负责，跟隐藏属性是正交的。
• 某些GUI应用（比如Windows资源管理器）默认不显示隐藏文件，但命令行里dir /a:h或ls -a照样能列出来——说到底，这只是显示策略的事。
• 如果你的程序需要处理“用户可见性”逻辑，一定要想清楚：你是想遵循系统UI惯例（查属性或查点号），还是自己实现一套过滤规则？这两者有本质区别。

Qt或Boost.Filesystem这类库没提供统一抽象

Qt的QFileInfo::isHidden()在Windows下会调GetFileAttributes，在macOS/Linux上则只是检查文件名是否以.开头；而Boost.Filesystem压根就没暴露is_hidden()接口。这意味着：你想写一行跨平台代码来解决这个问题，门儿都没有。

• 别指望std::filesystem::status()的file_type或perms字段——它们不携带隐藏信息。
• 如果项目已经在用Qt，直接用QFileInfo::isHidden()最省事；否则建议自己写一个轻量函数，按#ifdef _WIN32分支处理。
• 特别提醒：macOS上的.DS_Store或._*文件虽然也是隐藏文件，但._前缀并不是标准的POSIX隐藏约定，需要额外规则来匹配——不过通常这不属于通用“隐藏”判定的范畴。

实际写代码的时候，最容易漏掉的是Windows路径有效性校验，以及POSIX下.和..的边界情况。这两个点不处理好，要么误报，要么直接崩溃。