直接运行 pip install redis 即可安装最新稳定版(如 redis==8.0.1),默认启用 hiredis 加速(需系统已装 hiredis>=1.0);若环境无 hiredis,应显式执行 pip install "redis[hiredis]" 并按需安装编译依赖。

直接运行 pip install redis 就够了
绝大多数场景下,不需要额外参数或指定版本,pip install redis 会自动安装最新稳定版(截至 2026 年 8 月是 redis==8.0.1),且兼容 Redis 7.2–8.8 服务端。它默认启用 hiredis 加速(只要系统里有 hiredis>=1.0),响应解析更快,代码无需改动。
什么时候要加 [hiredis] 依赖
如果你的环境里没有预装 hiredis(比如某些 Docker 基础镜像、精简版 Python 容器),仅执行 pip install redis 会导致纯 Python 解析器回退,性能下降约 30%~50%。此时应显式安装:
-
pip install "redis[hiredis]"—— 引号防止 shell 把方括号当通配符 - Linux/macOS 下可能还需先装
hiredis编译依赖:sudo apt-get install build-essential python3-dev(Debian/Ubuntu)或brew install hiredis(macOS) - Windows 用户一般不用手动处理,
pip会拉取预编译 wheel
别随便指定老版本,除非你真在用旧 Redis
常见误操作是看到网上教程写 pip install redis==2.10.5 或 ==4.5.0 就照搬。但这些旧版本不支持 Redis 6+ 的 ACL、客户端缓存、RedisJSON 等特性,且已停止维护。只有当你明确对接的是:
- Redis 4.x 或 5.0 以下服务端,且无法升级
- 遗留项目强制锁死依赖(
requirements.txt中已有固定版本)
才考虑降级。否则一律用最新版,redis-py 的向后兼容性很好,API 断层极少。
StrictRedis 已被弃用,现在统一用 Redis
从 redis>=4.0.0 开始,StrictRedis 类只是 Redis 的别名,官方文档和源码里都标为 deprecated。你写:
import redis r = redis.Redis(host='localhost', port=6379, db=0)
就完事了。继续用 StrictRedis 不报错,但 IDE 可能标黄警告,而且未来版本会彻底移除。
redis-server 进程已在运行,且 host、port、db、认证密码(如有)全部匹配——库装得再对,连不上服务器也白搭。


















