BadgerDB 初始化需确保 dir 和 valueDir 为可写绝对路径并显式创建；键值均为 []byte，结构体须手动序列化；写操作必须事务 commit，迭代器值需拷贝避免脏读。
初始化 BadgerDB 实例时路径必须是可写目录
BadgerDB 启动失败最常见的原因是 dir 或 valueDir 指向只读路径、不存在的父目录，或权限不足。它不会自动创建父级目录，也不会提示“目录不存在”，而是直接 panic 报错：open /path/LOCK: permission denied 或 no such file or directory。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 始终用
os.MkdirAll(dir, 0755)显式创建数据目录（dir和valueDir都要） -
valueDir可与dir相同（默认行为），除非你明确要做 SSD/HDD 分离存储，否则别单独设 - 避免使用相对路径如
"./data"，改用filepath.Abs("./data")转为绝对路径，防止工作目录变动导致加载失败 - 初始化后务必调用
defer db.Close()，Badger 不支持进程内多实例共用同一目录
Put 和 Get 必须传入字节切片，不能直接传字符串或结构体
Badger 的键值都是 []byte，没有自动序列化。传入 string 会隐式转成 []byte（没问题），但传入 struct、int、bool 等会编译报错：cannot use ... (type int) as type []byte。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 字符串安全：用
[]byte("hello")或[]byte(s)即可 - 结构体必须手动序列化：推荐
encoding/json（轻量）或gob（Go 原生，性能略高），例如json.Marshal(user) - 读取后反序列化不能省：用
json.Unmarshal(val, &user)，注意val是只读的，别直接修改 - Key 长度建议 ≤ 64KB，Value ≤ 1GB，但实际中单 value 超 1MB 就要考虑拆分或用外部存储
事务未提交会导致写入丢失，且无任何错误提示
Badger 所有写操作必须在事务中进行，且必须显式调用 txn.Commit()。漏掉这一步，数据不会落盘，也不报错——程序看起来“执行成功”了，但重启后查不到。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 永远用
defer txn.Discard()开头，再在成功路径上用txn.Commit()替换掉它（避免 panic 时忘记 discard） - 不要复用
txn：每个逻辑单元（如一次 HTTP 请求处理）应新建事务，Badger 事务不是线程安全的 - 批量写优先用
db.Update()（自动 commit/discard），比手写db.NewTransaction(true)更安全 - 读事务用
db.View()，它内部自动Discard，不支持写
迭代器遍历需手动调用 Next()，且 Value() 返回的是只读引用
Badger 迭代器不是 Go 的 range 友好型。直接 for iter.Rewind(); iter.Valid(); iter.Next() 是标准写法，漏掉 iter.Next() 会死循环；而 iter.Value() 返回的 []byte 是底层内存的直接引用，下一次 Next() 后内容可能被覆盖。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 遍历时立即拷贝值：
valCopy := append([]byte(nil), iter.Value()...)，否则后续逻辑读到的是脏数据 - Key 同理，
iter.Key()也是只读引用，需拷贝才可长期持有 - 用
iter.Seek([]byte("prefix"))做前缀扫描时，确保 key 编码方式支持字典序（比如用binary.BigEndian.PutUint64存数字 key） - 大量扫描时加
opt.TableLoadingMode = options.MemoryMap提升速度，但会增加内存占用
