SQLite中如何在FTS5虚拟表上正确使用snippet()函数？

你写的调用语句无法运行的核心问题是漏传了第一个必填参数：关联的FTS5虚拟表名，传参顺序完全不符合函数定义。

按照规则，snippet()的第一个参数必须是当前查询对应的FTS虚拟表名称，之后才能传入文档提到的5个配置参数，完整参数顺序为：

• 第1位：FTS5虚拟表的表名，直接写表标识符即可，不要加字符串引号
• 第2位：目标列索引，列从左到右从0开始编号，传负值时自动选择匹配度最高的列返回
• 第3位：匹配关键词前插入的文本，通常传高亮起始标签
• 第4位：匹配关键词后插入的文本，通常传高亮结束标签
• 第5位：截断标识文本，当返回片段不是列的开头/结尾时，会在片段首尾自动加上这段文本
• 第6位：返回片段的最大token数，取值范围为1-64，超出范围会直接报错

正确调用示例 #

假设你的FTS虚拟表名为content_fts，需要实现自动选列、b标签高亮、最长8个token、截断位置显示...的效果，配合MATCH查询的写法如下：

SELECT snippet(content_fts, -1, '<b>', '</b>', '...', 8) AS search_snippet
FROM content_fts
WHERE content_fts MATCH '你的搜索关键词';

常见错误说明 #

1. 表名参数不能用引号包裹，否则会被识别为普通字符串，触发参数类型错误
2. 该函数必须和FTS表的MATCH查询搭配使用，没有全文搜索匹配上下文时无法生成有效片段
3. 你之前写的snippet(1, '<b>', '</b>', '...', 8)会把数值1识别为表名参数，SQLite不存在名为1的FTS表，自然会运行失败

内容的提问来源于stack exchange，提问作者John T