应直接使用bleve而非手写索引或strings.contains；权限错误需预建目录并设权限；复用索引用open()；字段搜索需正确配置mapping、分词器及查询类型。
直接用 bleve，别自己写倒排索引或硬套 strings.Contains——前者性能差、无分词、不支持布尔逻辑；后者连“run”搜不出“running”都解决不了。
bleve.New() 报 permission denied 怎么办
不是代码有 bug，是目录压根不存在或没写权限。Go 不会自动建父目录，也不会帮你改 chmod。
- 必须提前调
os.MkdirAll("/path/to/index", 0755)确保路径可写 - 绝对路径优先，避免
"./index"这类相对路径 —— 启动位置一变就失效 - Windows 下别硬写
"\index"，统一用filepath.Join("data", "myindex.bleve") - 已有索引要复用？用
bleve.Open()，不是bleve.New()；后者对非空目录会报invalid index format
字段没搜出来，八成是 mapping 配错了
bleve 默认不索引任何字段，全靠 IndexMapping 显式声明。字段名大小写、嵌套层级、类型定义，错一个就静默失败。
- 文本字段必须设
Index(true)且配 analyzer（比如"en"或中文"gojieba"），光Store(true)不行 - 数值/时间字段误设为
text类型，numeric_range查询会永远不命中 - 用
mapping.AddFieldMappingsAt("Body", bleve.NewTextFieldMapping())比AddFieldMappingsFromStruct更可控，后者只认json:tag，不自动开搜索 - 字段名必须和实际结构完全一致：比如 struct 里是
FileName string `json:"file_name"`，查询时就得写file_name:main.go，写FileName就查不到
搜索慢、结果不准、高亮失效的常见坑
不是数据量大，是 query 类型和用法没对上。QueryStringQuery 看似方便，但默认行为容易误导。
- 搜短语如
"fast http"，别用QueryStringQuery("fast http")—— 它只是字面匹配；要用bleve.NewPhraseQuery([]string{"fast", "http"}) - 模糊搜索别只依赖
golang~，它只对单个 term 生效且编辑距离固定为 1；需要更强容错，得用bleve.NewFuzzyQuery("golang").SetFuzziness(2) - 高亮别自己正则替换原文，
SearchRequest里设Highlight: &bleve.Highlight{}，返回的fragments已按位置对齐原文 - 并发写入 panic？多个 goroutine 直接调
index.Index()会触发concurrent map read and map write—— 加锁或用 channel 串行化写入
最易被忽略的一点：中文分词必须显式注册 gojieba analyzer 并绑定到字段，否则按字切分，搜“搜索引擎”会拆成“搜”“索”“引”“擎”，毫无意义。字段映射、分词器、查询类型这三者必须咬死对齐，缺一不可。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
