django默认搜索仅支持数据库级like或全文索引，不支持es的分词、同义词、相关性排序等能力；haystack提供解耦方案但需手动处理同步与索引，配置需严格匹配es 8+版本及分词器。
为什么 Django 默认搜索不能直接上 ElasticSearch
Django 自带的 __icontains 和 search 查找只走数据库 LIKE 或全文索引（如 PostgreSQL 的 to_tsvector），不支持分词、同义词、相关性排序、模糊匹配等 ElasticSearch 核心能力。硬套用会导致查询慢、结果不准、中文分词失效——尤其在商品标题、文章正文这类非结构化文本上。
Haystack 是唯一被广泛验证的 Django 与搜索引擎解耦方案，它把 ElasticSearch、Whoosh、Solr 抽象成统一接口，避免你写死搜索引擎逻辑。但注意：Haystack 本身不处理数据同步，也不自动建索引，这些得你手动补。
安装 Haystack + ElasticSearch 8.x 的关键步骤
Haystack 官方对 ES 8+ 支持较晚，必须用 haystack>=3.2.0，且底层依赖 elasticsearch>=8.0.0（不是 elasticsearch-py 旧包）。装错版本会报 ConnectionError: Connection refused 或 NotFoundError: No such index。
- 确认 ES 服务已运行：
curl -X GET "http://localhost:9200/"返回 JSON 版本信息 - 安装兼容组合：
pip install "django-haystack>=3.2.0" "elasticsearch>=8.0.0" -
settings.py中配置HAYSTACK_CONNECTIONS，注意 ES 8 默认启用 HTTPS 和身份认证，本地开发可关掉安全模块，否则要加http_auth参数 - 别漏掉
HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'，否则模型保存后不会自动更新索引
定义 SearchIndex 时最容易错的三件事
SearchIndex 不是 ORM 模型，它决定哪些字段进索引、怎么处理、是否存储。写错会导致查不到、字段为空、或同步失败。
立即学习“Python免费学习笔记（深入）”；
- 中文字段必须显式指定分词器：
text = indexes.CharField(document=True, use_template=True, analyzer='ik_max_word')，其中ik_max_word需提前在 ES 中安装 ik 分词插件并重启 -
use_template=True表示从模板文件读取内容，对应路径是search/indexes/myapp/mymodel_text.txt；如果忘了建这个模板，rebuild_index会静默跳过该字段 - 关系字段（如外键）不能直接写
indexes.CharField(model_attr='category__name')，ES 不支持嵌套点号访问，得重写prepare_category_name方法返回字符串
查询时怎么让关键词高亮又不破坏分页
Haystack 默认返回的是 SearchResult 对象，不是模型实例，所以不能直接用 .values() 或 .only()。高亮要用 ES 原生的 highlight 参数，但 Haystack 封装层默认不透出。
- 在视图中调用
SearchQuerySet时加参数：SearchQuerySet().filter(content=keyword).highlight() - 模板里用
{{ result.highlighted.content.0|safe }}取高亮片段（注意.0，因为highlighted返回列表） - 分页必须用
paginator = Paginator(sqst, 10)，不能用result_list直接分页，否则高亮信息丢失 - ES 8 的 highlight 默认用
unified类型，若需自定义标签，得在SearchQuerySet初始化时传highlight_kwargs={'pre_tags': ['<em>'], 'post_tags': ['</em>']}
ES 的 mapping 设计、分词器热更新、索引别名切换这些事，Haystack 不管。上线前得自己跑通 ./manage.py rebuild_index --noinput 和增量更新流程，不然搜出来全是空的。
