getfileattributes是windows下判断文件隐藏属性最直接高效的方式，通过检查file_attribute_hidden标志实现；linux/macos无对应系统属性，仅靠文件名以点开头约定识别隐藏文件。

Windows平台下用GetFileAttributes判断隐藏属性

在Windows上，GetFileAttributes 是最直接、开销最小的方式。它返回一个DWORD值，通过位与操作检查 FILE_ATTRIBUTE_HIDDEN 标志即可确认是否被标记为隐藏（注意：这仅反映文件系统属性，不等同于“用户不可见”或“受保护”）。

常见错误是忽略返回值为 INVALID_FILE_ATTRIBUTES 的情况——这意味着路径不存在、无访问权限，或传入了目录而非文件（但其实该函数对目录也有效，需结合业务逻辑判断）。

• 必须先调用 GetLastError() 判断失败原因，不能仅靠返回值是否为 -1 做判断
• 路径字符串建议使用宽字符版本 GetFileAttributesW，避免ANSI编码导致的路径截断或乱码
• 该属性可被任意进程修改，不具备安全性；仅适合UI层做显示过滤等轻量用途

Linux/macOS没有“系统隐藏属性”的概念

类Unix系统不提供类似Windows的文件系统级隐藏标志。所谓“隐藏文件”只是约定俗成：以 . 开头的文件名会被shell和多数工具默认忽略（如 ls 不显示，find 默认跳过）。这不是属性，而是名字规则。

因此，C++中无法用统一API跨平台检测“隐藏”，只能按平台区分处理：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• Linux/macOS下检查 std::filesystem::path::filename().string()[0] == '.'
• 不要试图用 stat.st_mode 或扩展属性（xattr）去模拟Windows行为——没有对应语义
• 若需兼容性封装，建议定义自己的枚举（如 FileVisibility::HiddenByConvention），而非强行映射为“系统属性”

跨平台代码里别硬套Windows逻辑

很多移植项目会把 GetFileAttributes 封装成通用接口，在Linux下调用时返回假值或抛异常，结果导致逻辑分支错乱。更稳妥的做法是明确分层：

• 业务层调用 is_file_hidden(const std::filesystem::path&) 这样的语义函数
• 实现层按OS宏分支：#ifdef _WIN32 走 GetFileAttributesW，否则走文件名前缀判断
• 避免在非Windows平台尝试读取NTFS流或调用Wine兼容层——既不可靠又增加依赖

注意：FILE_ATTRIBUTE_HIDDEN ≠ “用户看不见”

这个标志只影响资源管理器等遵循Windows Shell规范的程序，默认是否显示该文件。它不影响进程读写权限，也不阻止命令行 dir /a:h 或 attrib 查看。实际开发中容易混淆的是：

• 误以为设置了该属性就等于“加密”或“防删除”——完全不是一回事
• 在UWP或沙盒应用中，即使文件有此属性，也可能因包能力（capability）缺失而根本无法访问路径
• 某些备份工具或同步服务（如OneDrive）会主动忽略带此属性的文件，这是它们自己的策略，不是系统强制行为

真正需要保护文件内容，得靠ACL、加密或访问控制，而不是改个属性位。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！