在C++项目中接入Redis，最常用也最稳定的方式是使用hiredis库。hiredis是Redis官方提供的C语言客户端，由于C++兼容C，我们可以直接在C++代码里调用它的接口，完成与Redis服务器的连接、命令发送与结果解析。
一、安装hiredis库
以Ubuntu或Debian系统为例，可以通过源码编译安装hiredis。先下载源码并编译：
# 下载hiredis源码 git clone https://github.com/redis/hiredis.git cd hiredis make sudo make install # 更新动态库缓存 sudo ldconfig
安装完成后，头文件一般在 /usr/local/include/hiredis 目录，库文件为 libhiredis.so。
二、C++连接Redis基本示例
下面给出一个最简单的C++示例，演示如何连接本地Redis、执行 SET 与 GET 命令：
#include <iostream>
#include <hiredis/hiredis.h>
int main() {
// 连接Redis服务器，默认地址127.0.0.1，端口6379
redisContext* ctx = redisConnect("127.0.0.1", 6379);
if (ctx == nullptr || ctx->err) {
if (ctx) {
std::cerr << "连接错误: " << ctx->errstr << std::endl;
redisFree(ctx);
} else {
std::cerr << "无法分配redis上下文" << std::endl;
}
return 1;
}
// 执行SET命令
redisReply* reply = (redisReply*)redisCommand(ctx, "SET foo %s", "bar");
if (reply) {
std::cout << "SET结果: " << reply->str << std::endl;
freeReplyObject(reply);
}
// 执行GET命令
reply = (redisReply*)redisCommand(ctx, "GET foo");
if (reply) {
std::cout << "GET结果: " << reply->str << std::endl;
freeReplyObject(reply);
}
// 释放连接
redisFree(ctx);
return 0;
}
三、编译与链接
使用g++编译上述代码时，需要链接hiredis库：
g++ main.cpp -o redis_test -lhiredis
如果运行时提示找不到 libhiredis.so，请确认已执行 ldconfig，或临时设置库路径：
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
四、注意事项
- redisCommand 的格式化字符串用法类似 printf，注意参数类型匹配，避免缓冲区问题。
- 每次执行命令后必须调用 freeReplyObject 释放 reply，否则会造成内存泄漏。
- 生产环境中建议增加超时设置，可使用 redisConnectWithTimeout 代替 redisConnect。
- 若Redis设置了密码，连接后需先执行 redisCommand(ctx, "AUTH %s", "密码")。
五、小结
通过hiredis库，C++程序能以轻量方式直连Redis。核心步骤是安装库、调用 redisConnect 建立上下文、用 redisCommand 发命令、解析 redisReply 并释放资源。掌握这些基础后，你可以进一步封装连接池或异步接口来满足复杂业务需求。