Django适配PostgreSQL时如何手动指定SearchVector内容

场景1：让PostgreSQL执行to_tsvector计算，仅入参使用你预处理好的文本 #

默认给SearchVector传字符串会被识别为表字段名，要传入自定义文本需要用Value包裹：

1. 先导入依赖

from django.db.models import Value
from django.contrib.postgres.search import SearchVector

2. 直接赋值保存即可

# some_processed_text 为后端预处理好的待检索文本
obj.searchable = SearchVector(Value(some_processed_text))
# 可按需指定分词语言，比如中文分词
# obj.searchable = SearchVector(Value(some_processed_text), config='chinese')
obj.save()

该方案生成的SQL完全符合你预期的INSERT INTO ... SET searchable=to_tsvector(...)格式，不会读取表内其他字段的值。

场景2：完全不在PostgreSQL侧计算检索内容，直接写入预处理好的tsvector #

如果你已经在后端脚本中生成了符合PostgreSQL tsvector格式的结果，直接给字段赋值即可，不需要调用SearchVector：

# processed_tsvector 为你预生成的tsvector格式内容
obj.searchable = processed_tsvector
obj.save(update_fields=["searchable"])

该方案不会触发PostgreSQL侧的to_tsvector执行，所有检索内容计算都在业务端完成。

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