LevelDB是Google开发的轻量级单机嵌入式键值存储库，支持本地持久化与低延迟读写，但不支持SQL、网络访问或并发写入；需通过源码编译安装，提供Put/Get、WriteBatch批量操作及Iterator遍历功能。
LevelDB 是 Google 开发的轻量级、高性能、单机嵌入式键值存储库，用 C++ 编写，适合需要本地持久化、低延迟读写的场景（如缓存后端、日志索引、配置存储等）。它不支持 SQL、网络访问或并发写入（需外部同步），但接口简洁，集成容易。
一、安装 LevelDB（Linux/macOS）
推荐从源码编译，确保 ABI 兼容：
- 克隆官方仓库：git clone https://github.com/google/leveldb.git
- 进入目录并构建：cd leveldb && make（会生成 libleveldb.a 和头文件）
- 安装到系统（可选）：sudo make install（头文件到 /usr/local/include/leveldb/，库到 /usr/local/lib/）
使用时链接 -lleveldb -lpthread（后者因 LevelDB 内部依赖线程）。
二、基本读写操作（C++ 示例）
核心类是 leveldb::DB，通过 leveldb::Options 配置，用静态方法 leveldb::DB::Open() 打开数据库：
立即学习“C++免费学习笔记（深入）”；
#include <leveldb/db.h>
#include <iostream>
<p>int main() {
leveldb::DB* db;
leveldb::Options options;
options.create_if_missing = true; // 不存在则自动创建</p><p>leveldb::Status status = leveldb::DB::Open(options, "/tmp/testdb", &db);
if (!status.ok()) {
std::cerr << "Open error: " << status.ToString() << std::endl;
return 1;
}</p><p>// 写入
status = db->Put(leveldb::WriteOptions(), "name", "Alice");
if (!status.ok()) { /<em> handle </em>/ }</p><p>// 读取
std::string value;
status = db->Get(leveldb::ReadOptions(), "name", &value);
if (status.ok()) {
std::cout << "name = " << value << std::endl; // 输出 Alice
}</p><p>delete db; // 必须释放
return 0;
}
注意：key/value 均为 leveldb::Slice（即 const char* + len），支持任意二进制数据，不强制以 \0 结尾。
三、批量写入与原子性（WriteBatch）
单次 Put/Delete 是独立操作；如需原子性批量修改，用 leveldb::WriteBatch：
- 将多个操作暂存在 batch 中，一次提交，保证全部成功或全部失败
- 避免频繁磁盘 I/O，提升吞吐
leveldb::WriteBatch batch;
batch.Put("age", "30");
batch.Put("city", "Beijing");
batch.Delete("temp_key");
<p>status = db->Write(leveldb::WriteOptions(), &batch);
四、遍历所有键值（Iterator）
用 leveldb::DB::NewIterator() 获取迭代器，支持前向遍历：
std::unique_ptr<leveldb::Iterator> it(db->NewIterator(leveldb::ReadOptions()));
for (it->SeekToFirst(); it->Valid(); it->Next()) {
std::cout << it->key().ToString() << " => "
<< it->value().ToString() << std::endl;
}
if (it->status().ok()) {
// 迭代正常结束
} else {
// 处理错误
}
注意：Iterator 不是线程安全的，且在 DB 实例销毁前必须释放（unique_ptr 自动管理最安全）。
五、常见注意事项
- 线程安全：LevelDB 允许多个线程同时调用同一个 DB 实例的 const 成员函数（如 Get、NewIterator），但 非 const 操作（Put/Delete/Write）建议加锁，或每个线程独占 DB
- 错误检查不可省略：每个 API 返回 leveldb::Status，需显式判断 .ok()
- 路径权限：确保进程对数据库目录有读写权限，首次打开会创建子目录（如 /tmp/testdb/000003.log）
- 内存与性能：默认配置已较优；如需更高写吞吐，可增大 options.write_buffer_size（如 32MB）或启用压缩（options.compression = leveldb::kSnappyCompression，需链接 snappy）
