应显式声明tsvector类型并配合zhparser扩展和gin索引：建表时用search_vec tsvector，go中gorm需加gorm:"type:tsvector" tag，中文分词须安装zhparser并创建chinese配置，insert/update务必用to_tsvector('chinese', ...)生成值，查询用@@配合to_tsquery，排序用ts_rank()，推荐触发器自动更新tsvector字段。
tsvector字段怎么建才不踩坑
直接在表里加一个tsvector字段就行，但别用TEXT或JSONB假装替代——类型错，后续所有全文操作都会报错或静默失效。PostgreSQL对tsvector有严格校验，比如INSERT INTO docs (content, search_vec) VALUES ('hello', 'wrong type')会直接拒绝。
- 建表时显式声明类型：
search_vec tsvector，不是text、不是varchar - 如果用GORM，必须加
gorm:"type:tsvector"tag，否则AutoMigrate会忽略它或建错类型 - 不要手动INSERT/UPDATE
tsvector值（比如'hello':1 'world':2'这种字符串），除非你真懂词位格式；一律用to_tsvector()函数生成 - 中文需额外扩展（如
zhparser），默认english配置对中文只会切出单字，毫无意义
Go里怎么安全调用to_tsvector和@@操作符
用database/sql + lib/pq或pgx时，不能把to_tsvector('chinese', title)写死在Go字符串拼接里——参数没转义，SQL注入风险极高，且中文字符容易触发编码错误。
- 必须用占位符：
SELECT * FROM articles WHERE search_vec @@ to_tsquery($1, $2)，然后db.QueryRow(query, "chinese", userQuery) -
to_tsvector建议放在INSERT/UPDATE语句里，由数据库计算，避免Go层处理分词逻辑（Go没有可靠、轻量的中文分词库） - 如果要用
plainto_tsquery（用户输入不用写&符号），注意它对括号、引号敏感，传入前先简单过滤或用websearch_to_tsquery（PG 11+）更稳妥 - GIN索引必须建在
tsvector字段上，否则@@查询走不了索引，性能退化成全表扫描
中文分词为什么搜不到关键词
根本原因：PostgreSQL默认不带中文分词器。to_tsvector('english', '你好世界')结果是空或者'你':1 '好':2 '世':3 '界':4，完全没法匹配“你好世界”这个语义单元。
- 必须安装
zhparser扩展：CREATE EXTENSION zhparser;，再创建中文配置：CREATE TEXT SEARCH CONFIGURATION chinese (PARSER = zhparser); - 配置完要映射词典：
ALTER TEXT SEARCH CONFIGURATION chinese ADD MAPPING FOR ngram WITH simple;（具体取决于zhparser版本） - 建GIN索引时，确保用的是你刚建的
chinese配置：CREATE INDEX idx_docs_search ON docs USING GIN (search_vec)本身不指定配置，但填充search_vec时必须用to_tsvector('chinese', ...) - 验证分词效果：
SELECT to_tsvector('chinese', 'PostgreSQL全文检索很强大');，看输出是否含'全文检索'这类合理词位
排序和权重控制的实际写法
默认@@只返回匹配与否的布尔值，不排序。想按相关性排，必须用ts_rank()，但它不能直接和ORDER BY混用——函数返回float4，但若字段未加tsvector列或没GIN索引，性能会崩。
- 推荐写法：
SELECT *, ts_rank(search_vec, to_tsquery('chinese', $1)) AS rank FROM docs WHERE search_vec @@ to_tsquery('chinese', $1) ORDER BY rank DESC LIMIT 20 - 如果标题比正文权重高，用
setweight(to_tsvector('chinese', title), 'A') || setweight(to_tsvector('chinese', content), 'D')拼接，再存入search_vec -
ts_rank_cd()比ts_rank()更准（考虑词距），但计算开销略大，百万级以下数据用ts_rank()足够 - 别在WHERE里用
ts_rank() > 0.1过滤——这会让索引失效，先用@@缩小结果集，再排序取Top N
实际部署时最容易被忽略的是触发器自动更新tsvector字段。手写代码同步容易漏掉UPDATE场景，导致搜索结果陈旧。用数据库触发器兜底，比在Go层补逻辑更可靠。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
