推荐使用redis-plus-plus库连接Redis，基于hiredis提供同步/异步操作支持。1. 安装libhiredis-dev及redis-plus-plus源码编译；2. 用Redis("tcp://127.0.0.1:6379")创建连接，调用set/get/lpush等方法操作数据；3. 支持String、List、Hash、Set、ZSet等结构，语法类似STL；4. 编译时链接-lredis++ -lhiredis -pthread，确保Redis服务运行并检查防火墙。
在C++中连接和操作Redis数据库，推荐使用 redis-plus-plus 这个现代、易用且功能完整的客户端库。它基于 hiredis（Redis官方C客户端）构建，提供了更友好的C++接口，支持同步、异步操作以及STL容器的自然集成。
1. 安装依赖库 hiredis 和 redis-plus-plus
在使用之前，需要先安装底层的 hiredis 和 redis-plus-plus 库。
Ubuntu/Debian 系统：打开终端，执行以下命令：
- sudo apt-get update
- sudo apt-get install libhiredis-dev
- git clone https://github.com/sewenew/redis-plus-plus.git
- cd redis-plus-plus && mkdir build && cd build
- cmake ..
- make -j
- sudo make install
2. 编写 C++ 程序连接 Redis
下面是一个简单的同步连接和操作示例：
#include <iostream>
#include <sw/redis++/redis++.h>
using namespace sw::redis;
int main() {
try {
// 创建 Redis 连接对象
auto redis = Redis("tcp://127.0.0.1:6379");
// 设置一个字符串值
redis.set("name", "Tom");
// 获取值
auto val = redis.get("name");
if (val) {
std::cout << "name = " << *val << std::endl;
} else {
std::cout << "key not found" << std::endl;
}
// 操作 list
redis.lpush("tasks", {"task1", "task2"});
auto tasks = redis.lrange("tasks", 0, -1);
for (const auto &task : tasks) {
std::cout << "task: " << task << std::endl;
}
} catch (const RedisError &e) {
std::cerr << "Redis error: " << e.what() << std::endl;
}
return 0;
}
3. 支持的数据类型和常用操作
redis-plus-plus 支持 Redis 大多数数据结构，可以直接使用类似 STL 的语法：
立即学习“C++免费学习笔记（深入）”；
- String: set, get, incr
- List: lpush, rpop, lrange
- Hash: hset, hget, hgetall
- Set: sadd, smembers
- ZSet: zadd, zrange
- JSON（需 RedisJSON 模块）：可通过自定义命令操作
例如操作 Hash：
redis.hset("user:1001", "name", "Alice");
redis.hset("user:1001", "age", "25");
auto name = redis.hget("user:1001", "name");
if (name) std::cout << "User name: " << *name << std::endl;
4. 编译你的程序
编译时需要链接 redis++ 和 hiredis 库：
g++ -std=c++17 main.cpp -lredis++ -lhiredis -pthread -o redis_demo
注意：必须加上 -pthread，因为 redis-plus-plus 内部使用了线程。基本上就这些。只要 Redis 服务正常运行（默认端口 6379），你的 C++ 程序就能成功连接并操作数据。遇到连接失败时，检查 Redis 是否启动（redis-server）以及防火墙设置。
