【lucene】lucene常用查询一览
Lucene 里除了常见的 **TermQuery / BooleanQuery / PhraseQuery / FuzzyQuery / SpanNearQuery** 之外，还有不少“特殊家族”。下面按“族”归纳，一眼就能知道它们各自解决什么问题、跟普通倒排检索的差别在哪。
──────────────────
1. **Span 族（位置级）**
已在上面讲过 SpanNearQuery，再补两个常用成员：
- `SpanOrQuery` —— 多个 SpanQuery 取并集（位置层面 OR）。
- `SpanNotQuery` —— 先匹配 include，再剔除与 exclude 重叠的位置。
- `SpanContainingQuery`、`SpanWithinQuery`（sandbox）—— 判断一个 span 是否包含 / 位于另一个 span 内。
2. **Point 族（数值/多维数值）**
基于 BKD 树，不是倒排表。
- `PointRangeQuery`（Int/Long/Float/DoubleRange）
- `LatLonPoint.newDistanceQuery` / `newBoxQuery`（地理距离、矩形）
- `XYPoint.newBoxQuery`（二维笛卡尔坐标）
3. **DocValues 族（列存）**
直接扫列存，用于排序、聚合、过滤，不做倒排：
- `SortedSetSortField`、`LongDocValuesField.newRangeQuery`
- `DocValuesFieldExistsQuery`（过滤某列非空）
4. **Join 族（跨文档/跨字段 join）**
- `TermsQuery` （“大 ID 列表”查询，用于 filter cache）
- `ParentChildrenBlockJoinQuery` （嵌套文档父子关系）
- `ScoreMode.Avg/Total` 控制如何把子文档分数合并到父文档
5. **Vector 族（向量检索）**
基于 HNSW 图：
- `KnnVectorQuery`（TopK 近似最近邻）
- `FloatVectorSimilarityQuery`（显式指定相似度函数）
6. **Intervals 族（Lucene 8+ 新短语引擎）**
官方定位是“SpanQuery 的继任者”，语法更直观：
- `Intervals.phrase(...)`
- `Intervals.unordered()` / `ordered()` / `maxgaps(n)`
- `Intervals.notContain()` / `before()` / `after()`
7. **FunctionScore / Feature 族（评分公式可编程）**
- `FunctionScoreQuery`（把任意查询包起来，再用脚本函数改分）
- `FeatureField.newSaturationQuery`（用 BM25 + 饱和度特征）
8. **Script 族（脚本查询）**
- `ScriptScoreQuery`（完全由脚本决定文档是否命中、得多少分）
- `MatchAllDocsQuery` 的脚本版本：`_score = doc['price'].value * 0.7`
9. **Wildcard / Prefix / Regexp 族（通配正则）**
底层都是 **AutomatonQuery**（用 DFA 和 FST 交集）：
- `WildcardQuery` —— 通配符 `te?t`
- `PrefixQuery` —— 前缀 `abc*`
- `RegexpQuery` —— 正则 `ab+c.*`
10. **DisjunctionMaxQuery 族（取 max 而不是 sum）**
常用于“多字段同义搜索”，只取子句最高分，避免简单叠加导致的暴涨。
──────────────────
速查表
| 家族 | 数据结构 | 典型场景 | 是否走倒排 |
|---|---|---|---|
| Span | positions | 短语/邻近 | 是（positions） |
| Point | BKD 树 | 数值范围、地理 | 否 |
| DocValues | 列存 | 排序、聚合、存在性 | 否 |
| Join | 倒排 + 块结构 | 父子/嵌套 | 是 |
| Vector | HNSW | 向量检索 | 否 |
| Intervals | positions | 新短语 API | 是 |
| FunctionScore | 包装任意 Query | 自定义评分 | 取决于被包查询 |
| Script | 脚本引擎 | 任意规则 | 通常绕开倒排 |
| Automaton | FST+DFA 交集 | 通配/正则/模糊 | 是 |
把这 10 张“王牌”记住，基本能覆盖 Lucene 里 90% 的特殊查询场景。