Windows 下用 GetFileAttributes 检查 FILE_ATTRIBUTE_HIDDEN 属性位是最直接轻量的方式，需先通过 GetLastError 区分 INVALID_FILE_ATTRIBUTES 原因，再用位与判断；Linux/macOS 无系统级隐藏属性，仅靠文件名以 '.' 开头约定识别。
Windows 下用 GetFileAttributes 检查 FILE_ATTRIBUTE_HIDDEN
Windows 文件系统通过文件属性位标记隐藏状态，GetFileAttributes 是最直接、轻量的方式。它不依赖 shell API 或路径解析逻辑，也不需要打开文件句柄。
常见错误是只检查返回值是否为 INVALID_FILE_ATTRIBUTES 就断定“文件不存在”，但其实也可能是权限不足或路径无效；必须先排除这个错误，再判断属性位。
- 调用前确保路径是绝对路径或当前工作目录下可解析的相对路径，否则可能误报
- 返回值为
INVALID_FILE_ATTRIBUTES时，用GetLastError()区分是ERROR_FILE_NOT_FOUND还是ERROR_ACCESS_DENIED - 若返回值有效，用位与操作判断：
(attrs & FILE_ATTRIBUTE_HIDDEN) != 0 - 注意：目录也能被标记为隐藏，该方法同样适用
DWORD attrs = GetFileAttributes(L"config.ini");
if (attrs == INVALID_FILE_ATTRIBUTES) {
DWORD err = GetLastError();
if (err == ERROR_FILE_NOT_FOUND) { /* 不存在 */ }
} else if (attrs & FILE_ATTRIBUTE_HIDDEN) {
/* 是隐藏文件 */
}Linux/macOS 没有统一“隐藏文件”系统属性
Unix-like 系统不提供类似 Windows 的文件属性位，所谓“隐藏”只是 shell 和 GUI 工具约定俗成的行为：文件名以 . 开头即视为隐藏。这不是文件系统元数据，而是纯命名规则。
这意味着：stat() 或 access() 都无法告诉你“它是不是隐藏的”——只能你自己检查文件名。
立即学习“C++免费学习笔记（深入）”；
- 对
dirent::d_name或路径字符串，检查首字符是否为'.'（且不是"."或".."这类特殊目录项） - 注意跨平台代码中不要假设
st_flags或stat.st_mode包含隐藏标志——它们没有 - 某些文件系统（如 ext4）支持扩展属性，但桌面环境并不用它存“隐藏”状态，不可靠
跨平台判断逻辑不能只看系统 API
如果你写的是跨平台工具（比如配置加载器），直接按平台分支处理更稳妥，而不是试图抽象出一个统一的 is_hidden() 接口。
因为语义根本不同：Windows 是显式设置的属性，Linux 是隐式命名约定。混用会导致行为不一致——比如一个在 Linux 下叫 .gitignore 的文件，在 Windows 上复制过去并不会自动带 FILE_ATTRIBUTE_HIDDEN。
- Windows：查
GetFileAttributes+FILE_ATTRIBUTE_HIDDEN - Linux/macOS：检查
basename是否以'.'开头，且长度 > 1 - 不要尝试用
std::filesystem::status()的file_type或perms推断隐藏状态——它不包含该信息 - 如果路径来自用户输入，记得先做
std::filesystem::weakly_canonical()或等效处理，避免符号链接干扰 basename 提取
容易忽略的细节：NTFS 卷上的“系统隐藏文件”和 ACL 干扰
Windows 中有些文件（如 pagefile.sys）同时具有 FILE_ATTRIBUTE_HIDDEN 和 FILE_ATTRIBUTE_SYSTEM。单独检查 HIDDEN 位没问题，但如果你的逻辑是“非隐藏才处理”，那这类文件也会被跳过——这通常是预期行为，但得清楚这是设计使然，不是 bug。
更隐蔽的问题是：即使文件有 HIDDEN 属性，如果当前进程没有读取属性的权限（例如被 ACL 显式拒绝），GetFileAttributes 会失败并返回 ERROR_ACCESS_DENIED，而非告诉你“它是隐藏的”。这时候你既不知道它是否存在，也不知道它是否隐藏。
- 不要把
ERROR_ACCESS_DENIED当作“文件不存在”处理 - 如需高权限判断，得用
CreateFile打开句柄后调用GetFileInformationByHandle，但代价更大，一般没必要 - 多数场景下，权限不足时直接跳过或报错即可，无需强行穿透
