Java NIO.2在Windows上仅能可靠读取dos:hidden和basic:isHidden等基础隐藏属性，无法访问ADS、EFS加密状态、重解析点等NTFS原生隐藏机制。
Java 的 NIO.2（JSR-203）通过 AttributeView 体系支持跨平台的文件属性访问，但在 Windows NTFS 上，它**不直接暴露 NTFS 原生的隐藏机制**，比如备用数据流（ADS）、+h/+s 属性位、或 EFS 加密状态。它能读取的“隐藏相关”属性非常有限，且行为受底层实现和 JVM 版本影响。
Windows 下 NIO.2 实际可读的隐藏相关属性
NIO.2 在 Windows 上主要通过 DosFileAttributeView 和 BasicFileAttributeView 暴露部分 DOS 风格属性。真正可用、稳定、无需额外权限的只有：
-
dos:hidden：对应 NTFS 的“隐藏”属性（即attrib +h设置的标志）。可读可写，调用readAttributes("dos:hidden")或getAttribute("dos:hidden")能准确返回true/false。 -
dos:system：对应attrib +s。同样可读，但注意：单独设+s不会让文件在资源管理器中“消失”，仅与+h组合时增强隐蔽性。 -
basic:isHidden：这是BasicFileAttributeView提供的抽象属性，底层实际就是查dos:hidden，语义一致，推荐优先使用。
它读不到什么？为什么不能替代 attrib 或 PowerShell
以下关键 NTFS 隐藏能力，NIO.2 **完全无法访问**，也不在任何标准 AttributeView 规范中：
-
备用数据流（ADS）：如
file.txt:secret。Java 标准 API 没有 ADS 抽象，Files.list(Paths.get("file.txt"))只列出主流；Files.exists()对"file.txt:secret"返回false（除非用 JNI 或第三方库如ntfsstreams）。 -
文件夹的系统属性组合效果：NTFS 中一个文件夹同时带
+h和+s，才能在“显示隐藏项目”开启时也彻底不可见。NIO.2 虽能分别读这两个值，但无法判断“当前资源管理器是否启用显示隐藏项”这一 UI 状态，因此无法预测视觉可见性。 - EFS 加密状态、完整性校验（$LOGGED_UTILITY_STREAM）、对象 ID、重解析点（符号链接/挂载点）等元数据：这些属于 NTFS 内部结构，不在 Java 文件属性模型覆盖范围内。
实战代码：安全读取 dos:hidden 和 isHidden
以下示例使用标准 NIO.2，无需管理员权限，兼容 JDK 7+：
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
Path p = Paths.get("C:\Secret\config.dat");
try {
// 方法1：用 BasicView 读 isHidden（推荐，语义清晰）
boolean isHidden = Files.getAttribute(p, "basic:isHidden", LinkOption.NOFOLLOW_LINKS);
// 方法2：用 DosView 读 dos:hidden（更底层，明确指向 NTFS）
DosFileAttributes attrs = Files.readAttributes(p, DosFileAttributes.class);
boolean hiddenFlag = attrs.isHidden();
System.out.println("Is hidden (basic): " + isHidden);
System.out.println("Is hidden (dos): " + hiddenFlag);
} catch (IOException e) {
// 文件不存在、无读权限、路径非法时抛出
System.err.println("Cannot read attributes: " + e.getMessage());
}
注意：如果目标是目录，isHidden 含义不变；若需递归检查子项，需配合 Files.walk() 手动遍历。
需要读 ADS 或深层 NTFS 属性？得换方案
当业务真依赖 ADS 存储（如 CTF 隐写、取证分析），NIO.2 就不是工具。此时应：
- 调用系统命令：
Runtime.getRuntime().exec("cmd /c dir /r X:\path")解析输出，或用ProcessBuilder执行streams.exe -s（Sysinternals 工具）； - 使用 JNI 封装 Windows API（如
FindFirstStreamW）； - 改用 PowerShell 脚本，通过
Get-Item $path | ForEach-Object { $_.AlternateDataStream }获取流列表，再由 Java 调用执行。
本质上，NIO.2 是通用文件抽象层，不是 NTFS 驱动。它提供的是“操作系统普遍支持的最小公分母”，而不是“Windows 能做什么就暴露什么”。对隐藏属性的读取，它只负责把 attrib 能设的那两个基础位，稳稳地映射出来。
