安装 Redis 客户端只需执行 pip install redis，这是唯一必需步骤；服务端仅本地开发需额外安装，而 hiredis 和 redis-py-cluster 均为可选扩展。
直接装 redis 就够了，不需要额外装服务端，除非你要本地跑 Redis 实例。
pip install redis 是唯一必需步骤
Python 本身不带 Redis 支持，redis-py 是官方维护的客户端库，所有操作都基于它。其他名字如 redis-py-cluster 或 redis-py-hiredis 都是可选扩展。
- 运行
pip install redis即可完成安装，无需加--user或虚拟环境参数（除非你明确用了隔离环境） - 验证方式很简单：在 Python 交互式环境中执行
import redis，不报错就说明库已就位 - 旧项目若依赖
redis-py==4.x，仍可正常工作；新项目建议用最新稳定版（2026 年当前为 5.x），对 Python 3.12+ 兼容更好
redis-py 连接时常见错误和参数含义
装完库不代表能连上 Redis —— 这一步失败大多因为参数填错或服务没起来，不是客户端问题。
-
redis.Redis(host='localhost', port=6379, db=0)是最简连接，但实际中常需补全：password（有认证时）、decode_responses=True（避免返回bytes类型）、socket_connect_timeout=2（防卡死） - 错误
ConnectionRefusedError: [Errno 61] Connection refused表示 Redis 服务根本没运行，或监听地址/端口不对 - 错误
AuthenticationError说明密码错了，或者 Redis 配置里没开requirepass但你传了 password - Windows 用户注意：
localhost和127.0.0.1在某些网络配置下行为不同，优先试127.0.0.1
要不要装 hiredis？性能差异在哪
默认的 redis-py 用纯 Python 解析协议，加 hiredis 后底层改用 C 实现，解析速度提升明显，尤其在高频小响应场景（比如每秒上千次 GET）。
立即学习“Python免费学习笔记（深入）”；
- 装法：运行
pip install redis[hiredis]，它会自动拉取hiredis并启用，无需改代码 - 但注意：
hiredis在 Windows 上编译较麻烦，官方 wheel 包支持有限；macOS/Linux 更稳妥 - 如果你只是偶尔读写、做缓存开关或任务队列，不加 hiredis 完全够用；只有压测发现 CPU 卡在协议解析上才值得引入
RedisCluster 怎么选驱动
单机、主从、Proxy 模式用 redis.Redis() 就行；只有真正部署了 Redis Cluster（分片 + 去中心化拓扑）才需要 redis-py-cluster。
- 装法：
pip install redis-py-cluster，它和redis不兼容共存，导入名也不同：from rediscluster import RedisCluster - 别误以为“用了云服务商的集群实例”就一定要用这个——华为云/阿里云的 Proxy 集群对外表现仍是单点，用原生
redis.Redis()即可 -
RedisCluster初始化必须传节点列表，且不支持db参数（Cluster 没 db 概念），首次连接会自动刷新槽位映射，耗时略长
最容易被忽略的是：客户端装好了，但 Redis 服务压根没启动，或者防火墙拦掉了 6379 端口。先跑 redis-cli ping 确认服务可达，再动 Python 代码。否则你会花半小时调参数，其实问题出在服务层。
