Scanner.findWithinHorizon() 并非高效长文本搜索工具，而是受限于缓冲区与宽度参数的试探性匹配方法；其“快速”仅相对手动遍历而言，实际性能远逊Pattern/Matcher，且易因horizon过小、缓冲区限制或光标偏移导致匹配失败或遗漏。
Scanner.findWithinHorizon() 是什么，它真能“快速”检索？
它不是为长文本高效搜索设计的，而是 Scanner 在「当前未消费输入流中」按指定宽度限制找正则匹配的辅助方法。所谓“快速”是相对 nextLine() + 手动 String.indexOf() 的粗暴遍历而言，实际性能远不如 Pattern + Matcher 或 String.replaceAll() 等原生字符串工具。
它的核心限制在于：必须依赖 Scanner 的内部缓冲区状态，且默认只看「最多 n 个字符」（由参数决定），超出就返回 null —— 这意味着它天然不适合任意长度的长文本扫描。
为什么用 findWithinHorizon() 容易匹配失败或漏掉内容？
常见错误现象：findWithinHorizon("abc", 0) 返回 null；findWithinHorizon("\d+", 10) 在含 15 位数字的字符串里找不到；调用前没确认 Scanner 是否还有输入，直接抛 NoSuchElementException。
-
horizon参数为0时，表示“不限宽度”，但前提是底层Readable支持无限预读 ——System.in或文件流通常不支持，结果就是立即返回null - Scanner 内部缓冲区有大小限制（默认 1024 字节），即使设了大
horizon，也受限于已缓存的内容；未缓存部分根本不会被检查 - 它只搜索「尚未被 Scanner 消费过的部分」，如果之前调用了
next()或nextInt()，光标已移动，前面的内容就永远不可见了
替代方案：比 findWithinHorizon() 更可靠、更可控的长文本匹配方式
如果你手上有完整字符串（比如从文件读入的 String content），直接用 Pattern 和 Matcher 是最稳的选择；如果必须用 Scanner 流式处理大文件，应改用 hasNext(Pattern) / next(Pattern) 配合自定义分隔符。
立即学习“Java免费学习笔记（深入）”；
- 对已有字符串做匹配：
Pattern p = Pattern.compile("\b\w+@\w+\.\w+\b"); Matcher m = p.matcher(content); while (m.find()) { System.out.println(m.group()); } - 想让 Scanner 按正则切分（比如把日志按时间戳切块）：
scanner.useDelimiter(Pattern.compile("\d{4}-\d{2}-\d{2} \d{2}:\d{2}")); - 避免
findWithinHorizon()的陷阱：不用它做全文扫描，只在明确知道剩余输入很短、且需复用 Scanner 状态时才考虑（例如解析某行末尾的可选标记）
Scanner.findWithinHorizon() 的唯一合理使用场景
仅限于交互式输入或极小片段的“试探性查找”，比如用户刚输了一行，你想从中抓一个版本号，但又不想破坏后续用 nextLine() 读下一行的节奏。
- 确保调用前 Scanner 处于“刚读完上一项、光标停在待查区域开头”的状态（例如用
nextLine()后立刻调） -
horizon设为明显大于预期匹配长度的值（如100），但别设0—— 大多数 JDK 实现会退化成阻塞等待新输入 - 必须判空：
String match = scanner.findWithinHorizon("\d+\.\d+", 100); if (match != null) { ... }
真正处理 MB 级文本时，这个方法的存在感几乎为零。它是个边缘工具，不是搜索主力 —— 忘掉“快速检索长文本”这个误解，问题就解决了一大半。
