BoltDB 仅支持 []byte 类型的键和值，因此需将 Go 结构体序列化为字节流；推荐使用 JSON 序列化（需确保字段导出），兼顾可读性、兼容性与开发效率。
boltdb 仅支持 `[]byte` 类型的键和值，因此需将 go 结构体序列化为字节流；兼顾可读性、兼容性与开发效率，json 序列化是首选方案（前提是结构体字段已正确导出）。
BoltDB 是一个嵌入式、纯 Go 编写的键值型 NoSQL 数据库，其设计简洁高效，但底层只接受 []byte 作为键（key）和值（value）。这意味着任何 Go 原生类型（如 struct、int、string 等）在写入前都必须序列化为字节切片。对于用户结构体这类典型业务数据，JSON 序列化是最实用、最推荐的方式，原因如下：
- ✅ 天然支持结构体映射：encoding/json 可自动处理字段名转换、嵌套结构、基本类型（int、string、bool、time.Time 等需额外处理）；
- ✅ 人类可读、调试友好：存储内容为明文 JSON，便于直接查看、日志分析或手动修复；
- ✅ 跨语言兼容：未来若需与其他系统交互（如导出、API 对接），JSON 具备天然优势；
- ✅ 标准库、零依赖、稳定可靠：无需引入第三方序列化库，降低维护成本。
⚠️ 注意事项：
- 字段必须导出（首字母大写）：Go 的 json.Marshal 仅序列化导出字段。原始示例中 name、age 等小写字段将被忽略——务必改为 Name、Age 等。
- 敏感字段需谨慎处理：如 Password 字段，建议在序列化前脱敏（如设为空字符串或哈希后存储），避免明文密码落盘。
- 性能考量：JSON 解析/生成有轻微开销，若对吞吐量要求极高（如每秒万级写入），可考虑 gob（Go 原生二进制格式，更快但不可读、不跨语言）或 Protocol Buffers；但对绝大多数应用，JSON 的性能完全足够。
以下是一个完整、可运行的存储与读取示例：
package main
import (
"encoding/json"
"log"
"os"
"go.etcd.io/bbolt"
)
const usersBucket = "users"
type User struct {
Name string `json:"name"`
Age int `json:"age"`
Location string `json:"location"`
Password string `json:"password,omitempty"` // 使用 omitempty 避免空密码字段
Address string `json:"address"`
}
// Save 将用户保存到 BoltDB，以 Name 为 key
func (u *User) Save(db *bbolt.DB) error {
return db.Update(func(tx *bbolt.Tx) error {
b, err := tx.CreateBucketIfNotExists([]byte(usersBucket))
if err != nil {
return err
}
data, err := json.Marshal(u)
if err != nil {
return err
}
return b.Put([]byte(u.Name), data)
})
}
// LoadUser 根据用户名加载用户
func LoadUser(db *bbolt.DB, username string) (*User, error) {
var user User
err := db.View(func(tx *bbolt.Tx) error {
b := tx.Bucket([]byte(usersBucket))
if b == nil {
return os.ErrNotExist
}
data := b.Get([]byte(username))
if data == nil {
return os.ErrNotExist
}
return json.Unmarshal(data, &user)
})
if err != nil {
return nil, err
}
return &user, nil
}
// 使用示例
func main() {
db, err := bbolt.Open("users.db", 0600, nil)
if err != nil {
log.Fatal(err)
}
defer db.Close()
u := &User{
Name: "alice",
Age: 30,
Location: "Beijing",
Password: "hashed_pwd_abc123", // 实际应存哈希值
Address: "No.1 Street",
}
if err := u.Save(db); err != nil {
log.Fatal("Save failed:", err)
}
loaded, err := LoadUser(db, "alice")
if err != nil {
log.Fatal("Load failed:", err)
}
log.Printf("Loaded: %+v", *loaded)
}? 额外建议：
- 为避免键冲突，可采用命名空间前缀（如 "user:alice"）；
- 若需按年龄、地区等字段查询，BoltDB 不支持二级索引，需自行维护反向索引桶（如 age_index）；
- 生产环境务必添加错误处理与超时控制，并定期备份 .db 文件。
综上，对新手及常规业务场景，JSON + 导出字段是 BoltDB 存储结构体的最佳实践——简洁、安全、可维护，且与 Go 生态无缝集成。
