最常用、最轻量、官方推荐的C++连接Redis方式是使用hiredis库;需源码编译安装,手动管理redisContext和redisReply内存,建议封装RAII类并处理异常与连接池。

要用 C++ 连接 Redis,最常用、最轻量、官方推荐的方式是使用 hiredis —— 它是 Redis 官方维护的 C 语言客户端库,C++ 可直接调用(需注意 C 风格接口和内存管理)。
安装 hiredis
Linux/macOS 下推荐从源码编译安装,确保版本较新(如 v1.2.0+):
- 克隆仓库:
git clone https://github.com/redis/hiredis.git - 进入目录并编译:
make && sudo make install - 默认头文件装到
/usr/local/include/hiredis/,库文件到/usr/local/lib/libhiredis.a(或.so) - 若用 CMake,记得在
CMakeLists.txt中添加:find_package(hiredis REQUIRED)或手动指定路径
基础连接与命令执行
hiredis 是纯 C 接口,没有 RAII 封装,需手动管理 redisContext* 和 redisReply*:
- 用
redisConnect()连接(支持 host/port 或 unix socket);检查c->err判断是否成功 - 用
redisCommand()发送命令,返回redisReply*;必须调用freeReplyObject()释放 reply - 连接断开或超时后,
redisContext不可重用,需重新 connect
示例片段:
立即学习“C++免费学习笔记(深入)”;
redisContext *c = redisConnect("127.0.0.1", 6379);
if (c == nullptr || c->err) {
fprintf(stderr, "Connection error: %s\n", c ? c->errstr : "Unknown");
return -1;
}
redisReply *r = (redisReply*)redisCommand(c, "SET %s %s", "mykey", "hello");
if (r && r->type == REDIS_REPLY_STATUS && strcmp(r->str, "OK") == 0) {
printf("SET success\n");
}
freeReplyObject(r);
redisFree(c); // 必须调用
处理不同返回类型
redisReply 的 type 字段决定如何取值,常见类型有:
-
REDIS_REPLY_STRING→ 读r->str(注意:不保证以 \0 结尾,可用r->len) -
REDIS_REPLY_INTEGER→ 读r->integer -
REDIS_REPLY_ARRAY→ 遍历r->element[i],每个仍是redisReply* -
REDIS_REPLY_NIL→ 表示空值(如 GET 一个不存在的 key) -
REDIS_REPLY_ERROR→ 错误响应,读r->str获取错误信息
进阶建议:封装与异常安全
裸用 hiredis 易出错(忘记 free、未检查 reply 类型、连接异常未重试)。实际项目中建议:
- 写一个简单的 RAII 封装类(如
RedisClient),构造时 connect,析构时redisFree - 对
redisCommand做薄封装,自动freeReplyObject,并抛出异常或返回std::optional处理 NIL/ERROR - 需要高并发时,避免共享单个 context;可用连接池(如基于 std::queue + std::mutex 管理多个 context)
- 如需异步/管道操作,启用 hiredis 的 async 模式(配合 libevent 或 libuv),但 C++ 项目中更推荐用 modern-cpp-redis(基于 hiredis 的现代 C++ 封装)替代
基本上就这些。hiredis 本身不复杂,但细节(比如 reply 内存归属、连接生命周期)容易忽略。用熟之后,它稳定、高效、无依赖,是 C++ 操作 Redis 的可靠选择。









