Golang-DonutDB：用 Go 语言打造的极简嵌入式 Key-Value 数据库，让数据持久化像吃甜甜圈一样简单

摘要： 什么是 DonutDB？ DonutDB 是一个用 Go 语言编写的轻量级、嵌入式键值（Key-Value）存储库。它的设计哲学类似于 LevelDB 或 RocksDB，但旨在提...

什么是 DonutDB？

DonutDB 是一个用 Go 语言编写的轻量级、嵌入式键值（Key-Value）存储库。它的设计哲学类似于 LevelDB 或 RocksDB，但旨在提供更简单的 API 和更低的集成成本。

在现代微服务架构中，我们经常需要一个不需要独立部署、无需配置复杂网络协议，且能快速读写本地磁盘的存储方案。DonutDB 正是为了填补这个空白而生——它将数据库直接嵌入到你的 Go 二进制文件中，无需安装外部数据库服务（如 Redis 或 MongoDB），即可实现高效的数据持久化。

核心特性

1. 嵌入式部署：无需安装服务端，直接作为库引入项目，随程序启动而启动，随程序关闭而关闭。
2. 持久化存储：数据存储在本地文件系统中，确保程序重启后数据不丢失。
3. 高性能读写：针对 Key-Value 场景优化，提供极低延迟的访问速度。
4. 类型灵活：支持存储字节切片（[]byte），这意味着你可以存储任何可以序列化的数据（JSON, Protobuf, Gob 等）。
5. 轻量级依赖：尽量减少外部依赖，保持二进制文件的精简。

快速上手实例

为了让你快速理解 DonutDB 的工作方式，下面是一个完整的代码示例。该示例演示了如何初始化数据库、写入数据、读取数据以及删除数据。

1. 安装

首先，将项目添加到你的 Go 模块中：

go get github.com/psanford/donutdb

2. 完整代码实现

package main

import (
	"fmt"
	"log"

	"github.com/psanford/donutdb"
)

func main() {
	// 1. 初始化数据库
	// "donut_data" 是存储数据的文件夹名称
	db, err := donutdb.Open("donut_data")
	if err != nil {
		log.Fatalf("无法打开数据库: %v", err)
	}
	// 确保在程序退出前关闭数据库，释放资源并刷盘
	defer db.Close()

	// 准备一些测试数据
	key := []byte("user:101")
	value := []byte("{\"name\": \"Alice\", \"age\": 25}")

	// 2. 写入数据 (Put)
	fmt.Println("正在写入数据...")
	err = db.Put(key, value)
	if err != nil {
		log.Fatalf("写入失败: %v", err)
	}

	// 3. 读取数据 (Get)
	fmt.Println("正在读取数据...")
	val, err := db.Get(key)
	if err != nil {
		log.Printf("读取失败: %v", err)
	} else {
		fmt.Printf("读取成功！Key: %s, Value: %s\n", key, val)
	}

	// 4. 删除数据 (Delete)
	fmt.Println("正在删除数据...")
	err = db.Delete(key)
	if err != nil {
		log.Fatalf("删除失败: %v", err)
	}

	// 验证删除是否成功
	_, err = db.Get(key)
	if err != nil {
		fmt.Println("验证成功：数据已被删除。")
	}
}

深度解析：DonutDB 的适用场景

场景 A：本地缓存与状态持久化

如果你在开发一个 CLI 工具或桌面应用程序，需要保存用户的配置信息、登录 Token 或最近打开的文件记录，使用 MySQL 或 PostgreSQL 太过沉重。DonutDB 可以让你在几行代码内实现一个本地配置中心。

场景 B：边缘计算与 IoT

在资源受限的边缘设备（如树莓派或工业网关）上，运行一个完整的数据库实例会消耗大量内存。DonutDB 作为库运行，内存占用极低，非常适合存储传感器采集的临时数据。

场景 C：快速原型开发

在项目初期，你可能还不确定最终的数据模型，也不想花时间搭建数据库环境。使用 DonutDB 可以让你快速构建功能原型，待项目规模扩大后再迁移到分布式数据库。

与其他存储方案的对比

进阶建议：如何存储复杂对象？

由于 DonutDB 接收的是 []byte，在实际开发中，建议结合 encoding/json 或 google.golang.org/protobuf 来处理复杂结构体。

推荐模式：

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

// 写入时：
user := User{Name: "Bob", Age: 30}
data, _ := json.Marshal(user)
db.Put([]byte("user:102"), data)

// 读取时：
data, _ := db.Get([]byte("user:102"))
var user User
json.Unmarshal(data, &user)

总结

DonutDB 是一个典型的“小而美”的项目。它没有追求复杂的功能堆砌，而是专注于将“存储”这件事简化到极致。如果你需要一个无需运维、高性能且足够可靠的本地键值存储，DonutDB 是一个非常值得尝试的选择。