Telescope.nvim 内置高亮选择器结果限制机制解析

在 Telescope.nvim 插件中，builtin.highlights 选择器是开发者常用的功能之一，用于浏览和选择 Neovim 的各种语法高亮组。然而用户可能会注意到，当不输入任何搜索条件时，默认显示的结果列表并不完整，通常只能看到部分高亮组（如从 @ 开头到 N 开头的条目），而其他高亮组需要通过搜索才能显示。

这种现象实际上是 Telescope 的性能优化机制在起作用。Telescope 默认会限制一次性加载的结果数量，上限为 250 条。这种设计主要是为了避免在包含大量结果（某些文件类型可能有数百个高亮组）时，因排序和渲染导致的性能问题。

Telescope 提供了 temp__scrolling_limit 这个内部参数来控制这个限制。虽然标记为"临时"和"不稳定"，但这个参数已经稳定存在了两年多。用户可以通过以下方式调整显示数量：

:Telescope highlights temp__scrolling_limit=1000

从设计哲学来看，Telescope 更鼓励用户使用搜索功能而非手动浏览大量结果。这种交互模式与现代 IDE 的设计理念一致——当数据量庞大时，精确搜索比全量浏览更高效。不过对于需要完整浏览的场景，调整 temp__scrolling_limit 参数确实提供了灵活性。

值得注意的是，这个限制机制是 Telescope 核心设计的一部分，不仅影响高亮选择器，也会作用于其他可能返回大量结果的选取器。理解这一机制有助于开发者更高效地使用 Telescope，特别是在处理大型代码库或复杂文件类型时。

对于插件开发者来说，如果确实需要显示更多结果，除了调整参数外，也可以考虑实现自定义的排序和分页逻辑，或者通过预过滤来减少初始结果集的大小，从而在功能和性能之间取得平衡。