bleve 是 Go 项目里最实用的全文搜索方案——它不依赖外部服务、单二进制可运行、API 直接对应搜索语义，但用错配置或调用方式，会静默返回空结果，连错误都不报。
bleve.New() 报 permission denied 或 invalid index format 怎么办
这不是代码逻辑问题，是路径和生命周期没管好。
-
bleve.New()只能用于新建索引；对已有目录重复调用会报invalid index format—— 正确做法是用bleve.Open() - 路径必须提前存在且有写权限：
os.MkdirAll("/data/my_index", 0755)，别依赖bleve自动创建 - 避免相对路径：
"./index"在不同工作目录下失效，推荐用filepath.Join(os.Getenv("HOME"), "myapp", "index") - Windows 下路径分隔符统一用
filepath.Join()，别硬写"\"
字段明明写了却搜不到？mapping 和 struct tag 必须对齐
bleve 默认不索引任何字段，也不会自动推断结构体字段是否可搜——全靠 IndexMapping 显式声明。
-
AddFieldMappingsFromStruct(&MyDoc{})只按json:"title"tag 生成字段名，但不会默认设Index: true - 文本字段必须配 analyzer：
field.Analyzer = "en"（英文）或"jieba"（中文），光设Index(true)不生效 - 数值/时间字段若误设为
TextFieldMapping，numeric_range查询会静默失败 - 字段名严格区分大小写：
Title和title是两个字段，查询时也得写对
为什么 NewQueryStringQuery("title:go") 没结果？Query 类型和字段类型要匹配
QueryStringQuery 看似方便，但底层仍走分词链；搜不出往往不是关键词错，而是字段类型或 analyzer 不匹配。
- 想精确匹配字段值（如
status:200），字段 mapping 得设成"type": "keyword"，再用NewTermQuery("200")+field参数指定字段 - 搜短语（如
"Go tutorial"）必须用NewPhraseQuery()；QueryStringQuery里的双引号只是字面量，不触发 phrase 分析 - 中文搜不到？确认已注册
gojieba分词器，并在 mapping 中为字段指定Analyzer = "jieba"，否则默认按单字切分 - AND 多词搜索别只靠
title:go AND body:web—— 如果 analyzer 把AND当停用词过滤了，就查不到；更稳的是用NewBooleanQuery()拼子查询
并发写入 panic: concurrent map read and map write 怎么破
Index.Index() 不是线程安全的。多个 goroutine 直接往同一个 Index 实例写，跑一阵就会崩。
- 写操作必须加锁，或用
sync.Mutex包一层写方法 - 高频写场景建议批量提交：
index.Batch()+batch.Index()，比单条快且减少锁争用 - 读写分离：写入走单独 goroutine + channel 缓冲，搜索请求只读不写
- 重启后数据丢失？记得在程序退出前调
index.Close()，尤其用scorch存储引擎时，否则未落盘数据就没了
NewMatchQuery("keyword") 验证索引是否写入成功，再逐步加字段、换 query 类型——别一上来就堆复杂查询。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
