Files.walk 遍历需禁用符号链接并容错权限异常，逐行读取大文件防内存溢出，先判MIME或Magic Number过滤非文本文件，用picocli解析命令行，标准化路径并明确匹配规则。
用 Files.walk 遍历目录但别忽略符号链接和权限问题
Java 7+ 的 Files.walk 是最直接的递归遍历方式，但它默认会跟随符号链接，且遇到无读取权限的目录会直接抛出 AccessDeniedException，导致整个搜索中断。
- 用
FileVisitOption.NOFOLLOW_LINKS显式禁用符号链接遍历，避免循环或越权访问 - 在
FileVisitor的visitFileFailed方法中返回FileVisitResult.CONTINUE，跳过异常路径继续搜索 - 注意 Windows 下某些系统目录（如
C:\Program Files\WindowsApps）即使以管理员运行也可能被拒绝访问，必须容错
Files.walk(Paths.get("src"), FileVisitOption.NOFOLLOW_LINKS)
.filter(Files::isRegularFile)
.filter(path -> path.toString().endsWith(".java"))
.forEach(path -> searchInFile(path, "public static void main"));
用 BufferedReader 逐行搜索而非一次性读入内存
大文件（比如几百 MB 的日志）用 Files.readAllLines 容易触发 OutOfMemoryError；而正则 Pattern.compile + Matcher 虽灵活，但对超长行或二进制内容可能卡死或误匹配。
- 优先用
BufferedReader.readLine()逐行读取，配合String.contains()做简单子串搜索，性能高、内存稳 - 若需正则，每行单独 new 一个
Matcher，避免复用时状态污染；用Pattern.compile("...", Pattern.LITERAL)关闭元字符解析，防止用户输入*或.引发意外 - 注意编码：不要依赖平台默认编码，显式传入
StandardCharsets.UTF_8或从文件 BOM 推断
处理二进制文件和非文本文件的边界情况
用户指定搜索 "config"，但目标目录里混着 .jar、.png、.pdf —— 直接按文本读取会输出乱码甚至阻塞，readLine() 可能永远等不到换行符。
- 先用
Files.probeContentType(path)获取 MIME 类型，过滤掉application/、image/等非文本类型（注意该方法在某些 JDK 版本下可能返回 null） - 更可靠的做法是读取前几个字节判断 Magic Number：比如以
0x50 0x4B 0x03 0x04开头就跳过.jar/.zip - 或者加开关参数（如
--text-only），默认只处理常见后缀：.java、.xml、.properties、.json、.yml
命令行参数解析别手写 args[] 切分
用户执行 java SearchTool -d src -q "new HashMap<String" -i，手动解析 args 容易漏掉带空格、引号、尖括号的查询词，还无法支持长选项（--ignore-case）或参数校验。
立即学习“Java免费学习笔记（深入）”；
- 用 Apache Commons CLI 或 picocli —— picocli 更轻量，支持注解绑定，自动处理转义和 help 生成
-
-q值必须原样传递给搜索逻辑，不能被String.split(" ")破坏，尤其含正则特殊字符时 - 路径参数务必用
Paths.get(arg).toAbsolutePath().normalize()标准化，消除../和冗余/
真正难的不是“怎么搜”，而是“搜到什么算匹配”——比如大小写、全词、正则、Unicode 换行、BOM 头、混合编码文件。这些细节不提前约定清楚，工具一上线就会被用户反馈“为什么这个文件没搜到”。
