Windows用GetFileAttributesW判断FILE_ATTRIBUTE_HIDDEN标志，Linux/macOS仅检查文件名是否以点开头且长度大于1；二者均需避免硬编码、GUI API及扩展属性依赖。
Windows下用GetFileAttributes判断隐藏属性
在Windows平台，文件是否被标记为隐藏，本质是看其文件属性中是否设置了FILE_ATTRIBUTE_HIDDEN标志。直接调用Win32 API GetFileAttributes是最轻量、最可靠的方式，不需要打开文件或依赖Shell接口。
-
GetFileAttributes返回值为INVALID_FILE_ATTRIBUTES表示路径无效或无访问权限，需先检查 - 若返回值非无效值，用位与操作判断：
(attrs & FILE_ATTRIBUTE_HIDDEN) != 0 - 注意：该API不区分“系统隐藏”和“用户手动设为隐藏”，只要属性位被置位就返回true
- 路径必须是绝对路径或当前目录下存在的相对路径；若含中文或特殊字符，确保传入的是UTF-16（
wchar_t*）版本GetFileAttributesW
Linux/macOS没有“隐藏标记”，只认点开头命名
类Unix系统本身没有文件系统级的“隐藏属性”，所谓“隐藏”纯属shell和GUI文件管理器的约定：以.开头的文件名（如.gitconfig）默认不显示。因此C++里无法通过属性查询“是否被标记隐藏”，只能检查文件名。
- 提取文件名部分（不含路径），判断首字符是否为
'.'且长度大于1（排除.和..这类目录项） - 不要用
stat()或access()查属性——它们不提供隐藏状态信息 - 注意：某些桌面环境（如GNOME）会读取
.hidden文件来控制显示，但这属于应用层行为，不是系统级标记，C++程序不应依赖
跨平台封装时别混淆“隐藏”和“不可见”
写跨平台工具时，容易误把“文件不存在”“权限拒绝”当成“未隐藏”，或把macOS的com.apple.FinderInfo扩展属性当作通用隐藏标记——这些都不是标准做法。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- Windows走
GetFileAttributesW+FILE_ATTRIBUTE_HIDDEN - Linux/macOS只做
basename前缀检查，不查扩展属性或dotfile以外的机制 - 避免调用
SHGetFileInfo或NSFileManager等GUI层API——它们开销大、依赖运行环境，且结果可能受用户设置影响（比如Finder中“显示隐藏文件”开关） - 如果项目用了Boost.Filesystem，它不提供隐藏状态接口；C++17
std::filesystem同样不暴露该信息，必须平台特化处理
常见错误：误用FindFirstFile或硬编码属性值
有人用FindFirstFile遍历然后解析WIN32_FIND_DATA.dwFileAttributes，这可行但冗余——单个文件没必要走查找流程。更危险的是直接比较返回值等于某个整数（如== 4），因为FILE_ATTRIBUTE_HIDDEN宏值在不同SDK版本中稳定，但硬编码常量极易出错。
立即学习“C++免费学习笔记（深入）”；
- 永远用
#include <windows.h>并显式使用FILE_ATTRIBUTE_HIDDEN常量 - 不要假设
GetFileAttributes返回值是“仅含隐藏位”，它可能同时包含FILE_ATTRIBUTE_ARCHIVE或FILE_ATTRIBUTE_READONLY - 路径含重解析点（如符号链接、挂载点）时，
GetFileAttributes默认跟随链接；如需查链接本身属性，得用GetFileAttributesEx配合GET_FILEEX_NO_FOLLOW（Windows 8+）
