redis-py 指南（Python）

提示

来自deepseek解释

原文链接：https://redis.io/docs/latest/develop/clients/redis-py/

redis-py 是 Redis 的 Python 客户端。 以下各节说明如何安装 redis-py 并将您的应用程序连接到 Redis 数据库。

redis-py 需要一个正在运行的 Redis 服务器。请参见此处获取 Redis 开源版的安装说明。

您也可以使用对象映射客户端接口访问 Redis。更多信息请参见 RedisOM for Python。

安装

要安装 redis-py，请输入：

pip install redis

为了获得更快的性能，请在安装 Redis 时支持 hiredis。这提供了一个编译后的响应解析器，并且在大多数情况下不需要更改代码。默认情况下，如果 hiredis >= 1.0 可用，redis-py 会尝试使用它进行响应解析。

Python 的 distutils 打包方案已不再包含在 Python 3.12 及更高版本中。如果您在 Python 3.12 环境中安装 redis-py 遇到困难，请考虑更新到最新的 redis-py 版本。

pip install redis[hiredis]

连接与测试

连接到 localhost 的 6379 端口，在 Redis 中设置一个值并检索它。所有响应默认以字节形式返回。要接收解码后的字符串，请设置 decode_responses=True。更多连接选项，请参见这些示例。

存储并检索一个简单的字符串。

import redis

# 连接到 Redis
r = redis.Redis(host='localhost', port=6379, decode_responses=True)

# 设置一个字符串
r.set('foo', 'bar')

# 获取该字符串
value = r.get('foo')
print(value)  # 输出: bar

存储并检索一个字典。

# 使用哈希存储字典
r.hset('user:1', mapping={'name': 'Alice', 'age': 30})

# 获取整个哈希
user = r.hgetall('user:1')
print(user)  # 输出: {'name': 'Alice', 'age': '30'}

完成后关闭连接。

r.close()

更多信息

redis-py 网站提供了命令参考以及针对各种任务的教程。redis-py 的 GitHub 仓库中也有一些示例。

另请参见本节中的其他页面以获取更多信息和示例。