notdirectoryexception是java nio中目录操作失败后的运行时异常，非校验工具；应优先用files.isdirectory()预判路径是否为有效目录，必要时组合files.exists()和files.isreadable()增强健壮性。
NotDirectoryException 是 Java NIO 中的一个运行时异常，它在你试图对一个非目录路径执行本应只作用于目录的操作（如 Files.list()、Files.walk()、Files.createDirectory() 等）时被抛出。但它本身不是校验工具，而是一个“事后反馈”——即操作失败后才触发。因此，不能靠“捕获 NotDirectoryException 来校验”，而应提前判断路径是否为有效目录，避免异常发生。
用 Files.isDirectory() 主动判断目录有效性
这是最直接、推荐的做法：在执行目录相关操作前，先确认路径存在且是目录。
- 调用
Files.isDirectory(path)，返回true表示该路径存在、可访问，且是一个目录（而非文件或符号链接指向文件） - 它内部已处理了不存在、无权限、非目录等情形，返回
false即表示不符合目录预期（不抛异常） - 示例：
if (Files.isDirectory(dir)) {
try {
Files.list(dir).forEach(System.out::println);
} catch (IOException e) { /* 处理 I/O 错误 */ }
} else {
throw new IllegalArgumentException("路径不是有效目录: " + dir);
}
结合 Files.exists() 和 Files.isReadable() 做更严谨的预检
仅靠 isDirectory() 不足以覆盖所有边界情况（例如路径存在但无读取权限）。若需更高健壮性，可组合判断：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
Files.exists(path)：确保路径存在（不追踪符号链接） -
Files.isDirectory(path)：确认它是目录 -
Files.isReadable(path)：确保当前进程有读取权限（对list()、walk()等必需） - 三者同时为
true，才可安全进行目录遍历类操作
避免依赖 NotDirectoryException 做流程控制
虽然可以 try-catch 它，但属于反模式：
- 异常机制开销大，不适合常规逻辑分支
- 掩盖真实意图：你真正需要的是“这个路径能不能当目录用”，而不是“如果不行就报错再处理”
- 可能混淆其他 I/O 异常（如 SecurityException、AccessDeniedException），难以精准区分
- 代码可读性差，违背“快速失败 + 明确断言”的设计习惯
注意符号链接的默认行为
Files.isDirectory(path) 默认不跟随符号链接（即若 path 是指向文件的软链，返回 false；若指向目录，则返回 true）。如需不同策略，可传入 LinkOption.NOFOLLOW_LINKS（默认）或 LinkOption.FOLLOW_LINKS 显式指定。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
