使用hiredis库可高效实现C++与Redis交互。首先安装libhiredis-dev或hiredis-devel,再通过redisConnect连接Redis服务器,调用redisCommand执行SET、GET等命令,操作字符串、列表等数据类型,并用freeReplyObject释放响应结果,最后redisFree断开连接。编译时需链接-hiredis。

在C++中连接和操作Redis数据库,最常用的方式是使用官方推荐的C客户端库 hiredis。由于Redis本身是用C语言编写的,hiredis轻量高效,被广泛用于C/C++项目中的NoSQL数据交互。
安装 hiredis 库
在开始前,需要先安装 hiredis 动态库和头文件。以 Ubuntu/Debian 系统为例:
sudo apt-get update sudo apt-get install libhiredis-dev
如果你使用的是 CentOS 或 Fedora:
sudo yum install hiredis-devel
也可以从 GitHub 源码编译安装:
立即学习“C++免费学习笔记(深入)”;
git clone https://github.com/redis/hiredis.git cd hiredis make sudo make install sudo ldconfig // 刷新共享库缓存
编写 C++ 程序连接 Redis
使用 hiredis 连接 Redis 非常简单。以下是一个基本的同步连接示例,展示如何设置键值、获取值并处理响应。
#include#include int main() { // 1. 连接 Redis 服务器 redisContext *context = redisConnect("127.0.0.1", 6379); if (context == nullptr || context->err) { if (context) { std::cerr << "连接错误: " << context->errstr << std::endl; } else { std::cerr << "无法分配 redis context" << std::endl; } return -1; } std::cout << "成功连接到 Redis 服务器!" << std::endl; // 2. 执行 SET 命令 redisReply *reply = (redisReply*)redisCommand(context, "SET mykey 'Hello from C++'"); if (reply == nullptr) { std::cerr << "执行命令失败: " << context->errstr << std::endl; redisFree(context); return -1; } std::cout << "SET 命令执行结果: " << reply->str << std::endl; freeReplyObject(reply); // 3. 执行 GET 命令 reply = (redisReply*)redisCommand(context, "GET mykey"); if (reply != nullptr && reply->type == REDIS_REPLY_STRING) { std::cout << "GET mykey 的值: " << reply->str << std::endl; } else { std::cout << "键不存在或返回类型错误" << std::endl; } freeReplyObject(reply); // 4. 断开连接 redisFree(context); return 0; }
编译与运行
编译时需要链接 hiredis 库:
g++ -o redis_demo redis_demo.cpp -lhiredis
确保 Redis 服务正在运行:
redis-server --daemonize yes
然后运行程序:
./redis_demo
输出应为:
成功连接到 Redis 服务器! SET 命令执行结果: OK GET mykey 的值: Hello from C++
处理复杂数据类型与异常
Redis 支持多种数据结构,如列表、哈希、集合等。你可以通过发送相应的命令来操作它们。
例如,向列表添加元素并读取:
// 添加元素到列表
reply = (redisReply*)redisCommand(context, "LPUSH mylist 'item1'");
freeReplyObject(reply);
reply = (redisReply*)redisCommand(context, "LPUSH mylist 'item2'");
freeReplyObject(reply);
// 获取列表长度
reply = (redisReply*)redisCommand(context, "LLEN mylist");
if (reply->type == REDIS_REPLY_INTEGER) {
std::cout << "列表长度: " << reply->integer << std::endl;
}
freeReplyObject(reply);
// 获取所有元素
reply = (redisReply*)redisCommand(context, "LRANGE mylist 0 -1");
if (reply->type == REDIS_REPLY_ARRAY) {
for (size_t i = 0; i < reply->elements; ++i) {
std::cout << "元素 " << i << ": " << reply->element[i]->str << std::endl;
}
}
freeReplyObject(reply);
注意判断 reply->type 类型,避免空指针或类型不匹配导致崩溃。
异步操作(可选进阶)
hiredis 还提供异步 API(hiredis async),适用于高并发场景。它基于事件循环,可与 libevent、libev 等集成,实现非阻塞通信。
对于大多数中小型应用,同步接口已足够高效。
基本上就这些。掌握 hiredis 后,C++ 与 Redis 的交互变得直接而高效。










