Fuse.js
本篇范围
本篇聚焦 Fuse.js —— 零依赖、纯前端可用的轻量「模糊搜索」库。它与「精确匹配（includes / 正则）」「后端搜索引擎（Elasticsearch 等）」「语义搜索（向量嵌入）」同属「应用内搜索」选型方向，本篇在取舍与对比时一笔带过另几者。版本基线 Fuse.js 7.x（本仓库锁定 7.4.2，TypeScript 编写、零运行时依赖、ESM/CJS 双产物）。
Fuse.js 让你把一份数据数组「喂」给 new Fuse(list, options)，随后用 fuse.search(pattern) 做容错的模糊匹配：即使查询词有拼写错误（把 John 打成 jon），也能按相关度返回结果。核心是 Bitap 算法——把查询编码成位掩码、用位运算并行扫描所有字符位置，并维护多个「错误级别」（R0、R1…）来容忍插入/删除/替换。整个过程完全在内存中完成，不需要后端、不需要搜索服务器、不需要外部索引服务。
它不引入任何新数据结构：进出都是普通数组/对象；结果以 { item, refIndex, score, matches } 回指源数据。最常用的配置是 keys（指定在对象的哪些字段上搜索，支持点号路径、数组路径、{ name, weight } 加权）。匹配的宽严由 threshold（默认 0.6，越小越严格）控制；相关度用 score 表示，0 是完美匹配、1 是完全不匹配（越小越相关，切勿讲反）。2026 年的现状：稳定版已到 v7.4.2（2026-06 发布），完整构建约 8.6KB（min+gzip），并提供更小的 basic 构建（约 6.8KB）。
评价
优点
- 零依赖 + 纯前端：一个文件即可用，无需后端/搜索服务，离线可用、即时零延迟
- 开箱即用的容错：基于编辑距离的模糊匹配，能容忍拼写错误与近似输入
- 不改数据形态：用普通数组/对象，结果用
item/refIndex回指源数据，无需转换 - 字段级表达力：
keys支持点号路径、数组路径、{ name, weight }加权，覆盖嵌套与多字段 - 高亮友好：
includeMatches返回命中区间（indices/value/key），便于做搜索高亮 - 可调可控：
threshold/location/distance/ignoreLocation/minMatchCharLength精细控制宽严与位置 - 进阶能力齐全：扩展搜索语法、逻辑搜索（
$and/$or）、预建索引（createIndex/parseIndex）、Web Worker
缺点
- 只懂「字形」不懂「语义」：词法级模糊匹配，搜
car不会因近义召回automobile（那是语义搜索的活） - 位置默认有约束：默认
location=0/distance=100，长文本里靠后的词易匹配不上，需ignoreLocation或调distance - 数据需全量入内存：适合中小数据集；上千万文档、复杂聚合、分布式检索应交给后端引擎
- 同步 CPU 计算：大数据集每次按键全量搜会卡 UI，需 debounce、预建索引或移到 Web Worker
- score 方向反直觉：
0才是最匹配，新手极易理解反 - 过松会噪声多：
threshold偏大或不加位置约束时，弱相关结果会混进来，需调参