需先用os.mkdirall创建索引目录并设权限，避免permission denied；索引已存在时应调用bleve.open()而非bleve.new()；字段必须显式配置index(true).store(true)，中文需注册并设置jieba分词器。
bleve.New() 报 permission denied 怎么办
直接运行就崩，错误是 open /path/to/index: permission denied，不是权限被系统拦了，是目录压根不存在。Go 不会自动创建父级路径，也不会帮你 chmod。
- 必须提前调
os.MkdirAll("/abs/path/to/index", 0755)，不能只建最后一级 - 绝对别用
"./index"这类相对路径——CI 构建、systemd 启动、IDE 调试时工作目录不一致，一跑就挂 - Windows 下路径拼接别手写
"C:\myapp\index"，统一用filepath.Join("C:", "myapp", "index") - 如果索引目录已存在且想复用，该用
bleve.Open()，不是bleve.New()；后者对已有数据会报invalid index format
字段存进去了却搜不到，mapping 怎么配才生效
文档 index.Index("id", doc) 成功返回，但 SearchRequest 总是零结果，90% 是字段没真正“打开索引开关”。Bleve 默认所有字段都不索引、不存储，全靠 IndexMapping 显式声明。
-
mapping.AddFieldMappingsFromStruct(&MyDoc{})只按json:"title"tag 拿字段名，不会自动设Index(true) - 文本字段必须链式调用：
field.IndexingOptions().Store(true).Index(true)，缺一不可 - 中文字段还得额外绑定分词器：先注册
gojieba.Analyzer，再设titleField.Analyzer = "jieba"，漏掉mapping.DefaultAnalyzer = "jieba"就切不开“搜索引擎” - 数值字段若误设为
text类型，numeric_range查询会静默失败——不报错、不返回，就是查不到
QueryStringQuery 搜不出东西，字段名和语法有啥坑
bleve.NewQueryStringQuery("title:go AND body:web") 写得看似标准，但实际常失效。问题不在关键词，而在字段名匹配规则和 analyzer 行为。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 字段名必须和 mapping 中定义的完全一致：mapping 里是
"Title"（大写 T），query 里就不能写title: -
AND/OR默认会被英文 analyzer 当停用词过滤掉，更稳的是用bleve.NewBooleanQuery()拼接子查询 - 短语搜索别写
"fast http"——QueryStringQuery里的双引号只是字面量，不触发 phrase 分析；该用bleve.NewPhraseQuery([]string{"fast", "http"}) - 模糊搜索别只依赖
golang~，它只对单个 term 生效且编辑距离固定为 1；需要控制容错率，得用bleve.NewFuzzyQuery("golang").SetFuzziness(2)
并发写入 panic: concurrent map read and map write
多个 goroutine 直接调 index.Index()，跑一阵就 crash，错误信息是 fatal error: concurrent map read and map write。这不是 Go 的 bug，是 Bleve 的设计限制。
-
bleve.Index实例本身**不支持并发写入**，官方没加锁，也没做内部同步 - 简单方案：用
sync.Mutex包一层写操作，或改用index.Batch()批量提交 - 高吞吐场景建议引入 channel + 单 writer goroutine 模式，避免锁竞争
- 读操作（
index.Search()）是并发安全的，不用额外保护
最易被忽略的点：中文分词器注册后，还得显式把 DefaultAnalyzer 设成 jieba；否则 mapping 里每个字段都得单独配 Analyzer，漏一个，“人工智能”就变成“人 工 智 能”四个独立 term。
