Windows下用GetFileAttributes判断隐藏属性需先校验返回值是否为INVALID_FILE_ATTRIBUTES，再位与FILE_ATTRIBUTE_HIDDEN；Linux/macOS无对应属性，靠文件名是否以.开头判断，跨平台应封装抽象接口而非硬编码分支。
Windows下用GetFileAttributes判断隐藏属性
在Windows平台，C++判断文件是否被标记为隐藏，最直接的方式是调用系统API GetFileAttributes，它返回一个DWORD值，其中包含FILE_ATTRIBUTE_HIDDEN标志位。
注意：该函数不支持UNC路径（如\servershare ile.txt）直接传入，需先映射为本地驱动器号，或改用GetFileAttributesEx配合GET_FILEEX_INFO_LEVELS::GetFileExInfoStandard——但后者行为一致，仍需路径可访问。
- 若返回值为
INVALID_FILE_ATTRIBUTES（即-1），说明路径无效、权限不足或文件不存在，不能直接拿结果与FILE_ATTRIBUTE_HIDDEN做位与 - 正确做法是先校验返回值非
INVALID_FILE_ATTRIBUTES，再用&操作提取标志：attrs & FILE_ATTRIBUTE_HIDDEN - 该属性仅反映文件系统层面的“隐藏”标记，和资源管理器是否显示无关（例如用户关闭了“显示隐藏文件”选项时，即使未设隐藏属性，文件也不可见）
Linux/macOS没有等价的“隐藏属性”，靠文件名前缀判断
类Unix系统本身不提供类似Windows的FILE_ATTRIBUTE_HIDDEN元数据。所谓“隐藏文件”，只是约定俗成地将文件名以.开头（如.gitconfig），shell和GUI工具据此决定是否默认列出。
这意味着：你无法用stat()或filesystem::status()读出一个“隐藏标志位”，只能检查文件名。
立即学习“C++免费学习笔记（深入）”；
- 用
std::filesystem::path::filename()获取最后一级名称，再判断.string()[0] == '.' - 注意空文件名、路径结尾为
/等情况，filename()可能返回""，需先确认路径有效且非根目录 -
readdir()默认会返回所有条目（包括.和..），不跳过“隐藏”项；真正过滤要靠上层逻辑，不是系统行为
跨平台代码别硬写宏开关，优先封装抽象接口
混合判断逻辑容易出错，比如有人写#ifdef _WIN32分支分别调API和检查点号，但忽略了Windows下也允许存在以.开头的文件（它不自动变隐藏），而Linux下chattr +h（ext4）或setfilecrtype（macOS）等扩展属性并不被标准库识别。
- 明确需求场景：是做配置文件发现（应同时检查
.env和env.ini）？还是清理临时文件（需识别.tmp和~$document.docx）？不同目标对应不同策略 - 避免把“隐藏”当作布尔开关来用；更稳妥的是定义
is_ignored_for_listing(const std::filesystem::path& p)，内部按平台+业务规则组合判断 - 不要依赖
std::filesystem::is_hidden()——C++20标准根本没这个函数，某些编译器扩展（如MSVC的_is_hidden）非标准且不可移植
权限不足时GetFileAttributes可能误报“非隐藏”
当程序对目标路径只有读权限、无遍历权限（如进入某子目录需FILE_LIST_DIRECTORY），GetFileAttributes可能失败并返回INVALID_FILE_ATTRIBUTES，此时若忽略错误直接返回false（“不是隐藏”），就错了。
- 典型错误写法：
return GetFileAttributes(path.c_str()) & FILE_ATTRIBUTE_HIDDEN;—— 未检查返回值，INVALID_FILE_ATTRIBUTES是-1，-1 & 非零值结果非零，反而误判为隐藏 - 必须显式比较：
DWORD attrs = GetFileAttributes(path.c_str()); return (attrs != INVALID_FILE_ATTRIBUTES) && (attrs & FILE_ATTRIBUTE_HIDDEN); - 对于网络驱动器或OneDrive同步文件夹，还可能出现
ERROR_SHARING_VIOLATION等间接错误，GetLastError()需结合具体上下文处理，不能一概视为“文件不存在”
