Storm不是ORM，而是BoltDB的轻量级封装，缺乏关系映射、外键、迁移和查询构建器，仅适用于单机、读多写少、结构简单的配置存储或缓存场景。
Storm 是什么，为什么它不适合当 ORM 使用
Storm 不是 ORM，它只是 BoltDB 的轻量级封装，没有关系映射、外键、迁移或查询构建器。如果你期待类似 GORM 或 Ent 的体验，会立刻卡在关联查询和事务控制上。
它适合的场景很窄：单机、读多写少、结构简单、不需要并发写入的配置存储或缓存层。比如保存用户偏好、本地任务队列状态、CLI 工具的持久化数据。
-
storm库本身不支持嵌套结构自动展开，struct字段必须是可序列化的基础类型或指针，切片和 map 会被忽略（除非用storm自带的Index标签配合自定义序列化） - 没有连接池概念，每次
storm.Open都打开一个 BoltDB 文件句柄，频繁调用会导致too many open files - 所有操作默认在 BoltDB 的
Update事务中执行，但无法手动控制事务边界——你不能跨多个Save或Delete打包成一个原子操作
正确初始化 Storm 实例并复用 DB 句柄
不要在每个函数里都调用 storm.Open，也不要在 main() 里直接 defer db.Close()——这会让整个程序生命周期内只用一个句柄，但若服务长期运行且有并发写入，BoltDB 会因写锁阻塞明显。
推荐方式是全局单例 + 按需获取句柄，并确保关闭时机可控：
立即学习“go语言免费学习笔记（深入）”；
var db *storm.DB
func initDB() error {
d, err := storm.Open("data.db")
if err != nil {
return err
}
db = d
return nil
}
// 使用时：
func saveUser(u User) error {
return db.Save(&u) // storm 内部会新开事务，用完自动 Close
}
-
storm.Open返回的*storm.DB是线程安全的，可全局复用 - 所有
db.Save/db.One/db.All等方法内部已封装事务，无需手动Begin和Commit - 如果需要批量写入，用
db.Batch，否则逐条Save性能极差（每条都开一次事务）
定义 struct 时绕过 Storm 的字段限制
Storm 默认只序列化导出字段（首字母大写），且不支持嵌套 struct 直接存为子文档。常见翻车点是把 time.Time 或 map[string]interface{} 直接放 struct 里，结果查出来字段为空。
正确做法：
- 时间字段用
int64存 Unix 时间戳：CreatedAt int64 `storm:"index"`，读取时再转time.Unix(createdAt, 0) - 避免在 struct 中直接使用
map或slice；如需存储 JSON 结构，声明为string并手动json.Marshal/json.Unmarshal - 主键必须叫
ID（大写），类型为int、int64或string；否则db.One查不到 - 索引字段加
storm:"index"标签，但注意 BoltDB 不支持复合索引，storm也做不到
查询性能差？别用 All + filter，改用 Index 查询
db.All(&users) 加 for 循环过滤是反模式——它会全表扫描，1000 条记录就明显卡顿。Storm 的 Find 和 Index 才是真·加速手段。
例如按用户名查用户：
type User struct {
ID int `storm:"id"`
Username string `storm:"index"`
Email string
}
// 正确：走索引
var u User
err := db.One("Username", "alice", &u)
// 错误：全量加载再过滤
var users []User
db.All(&users)
for _, u := range users {
if u.Username == "alice" { ... }
}
-
storm的索引是 BoltDB 的 bucket + key 映射，不是 B-tree，所以只支持等值查询（One）、前缀匹配（Prefix）和范围（Between），不支持>/<单边条件 - 字符串索引对大小写敏感，
"Alice"和"alice"是不同 key - 如果需要模糊搜索或复杂条件，得自己用
db.Bolt访问底层 BoltDB，或者换 SQLite + GORM
真正麻烦的从来不是怎么写代码，而是发现 Storm 的“简单”背后全是妥协：没事务控制、没嵌套、没模糊查、没迁移。选它之前，先确认你的数据真的只是“存一下”，而不是“管起来”。
