快捷導(dǎo)航

redis-py在Python中連接與使用Redis全過(guò)程

更新時(shí)間：2025年11月04日 10:00:22 作者：Hello.Reader

文章介紹了如何在Python項(xiàng)目中安裝和使用redis-py庫(kù)連接Redis,包括連接測(cè)試、核心功能、高級(jí)用法和配置優(yōu)化,還提供了官方文檔和示例代碼的鏈接,幫助開(kāi)發(fā)者進(jìn)一步學(xué)習(xí)和深入應(yīng)用Redis

一、安裝 redis-py

首先，確保已經(jīng)安裝并啟動(dòng)了一臺(tái) Redis 服務(wù)。請(qǐng)參閱官方文檔完成 Redis 服務(wù)器的安裝與啟動(dòng)。

在項(xiàng)目環(huán)境中執(zhí)行：

pip install redis

Tip：如果希望獲得更快的響應(yīng)解析性能，可以額外安裝 hiredis：

pip install redis[hiredis]

如果系統(tǒng)中存在 hiredis>=1.0，redis-py 會(huì)自動(dòng)使用它進(jìn)行底層二進(jìn)制協(xié)議解析，無(wú)需修改代碼。

注意：Python 3.12 以后的標(biāo)準(zhǔn)庫(kù)移除了 distutils，舊版本的 redis-py 可能會(huì)安裝失敗，建議使用最新穩(wěn)定版 redis-py。

二、連接到 Redis 并測(cè)試

在代碼中導(dǎo)入并創(chuàng)建客戶(hù)端實(shí)例：

import redis

# 默認(rèn)連接到 localhost:6379，decode_responses=True 可直接返回字符串
r = redis.Redis(host='localhost', port=6379, decode_responses=True)

host 與 port：Redis 服務(wù)地址與端口；
decode_responses=True：將返回的 bytes 自動(dòng)解碼為 str。

示例：字符串讀寫(xiě)

# 寫(xiě)入
r.set('foo', 'bar')      # 返回 True

# 讀取
value = r.get('foo')     # 返回 'bar'

示例：Hash（字典）讀寫(xiě)

# 批量寫(xiě)入 Hash
r.hset('user:123', mapping={
    'name': 'Alice',
    'email': 'alice@example.com',
    'age': 30
})

# 讀取整個(gè) Hash
session = r.hgetall('user:123')
# 返回 {'name': 'Alice', 'email': 'alice@example.com', 'age': '30'}

三、核心特性速覽

功能	方法示例
字符串	r.set(), r.get()
列表 List	r.lpush(), r.rpop()
集合 Set	r.sadd(), r.smembers()
有序集合 ZSet	r.zadd(), r.zrange()
哈希 Hash	r.hset(), r.hgetall()
管道 Pipeline	pipe = r.pipeline(); pipe.set(...); pipe.execute()
事務(wù) Transaction	with r.pipeline() as pipe: pipe.multi(); …
發(fā)布/訂閱 Pub/Sub	pub = r.pubsub(); pub.subscribe('chan')
掃描迭代 SCAN	r.scan_iter(), r.hscan_iter()

更多高級(jí)用法，請(qǐng)參考 redis-py 官方文檔。

四、常見(jiàn)配置與調(diào)優(yōu)

連接池

pool = redis.ConnectionPool(host='localhost', port=6379, db=0)
r = redis.Redis(connection_pool=pool)

復(fù)用 TCP 連接、提升并發(fā)性能。

超時(shí)與重試

r = redis.Redis(socket_timeout=5, socket_connect_timeout=5, retry_on_timeout=True)

防止網(wǎng)絡(luò)抖動(dòng)導(dǎo)致阻塞。

SSL/TLS 連接

r = redis.Redis(
    host='redis.example.com', port=6380,
    ssl=True, ssl_certfile='client.crt', ssl_keyfile='client.key',
    ssl_ca_certs='ca.pem'
)

在云環(huán)境或生產(chǎn)集群中啟用加密傳輸。

五、深入學(xué)習(xí)資源

示例倉(cāng)庫(kù)：https://github.com/redis/redis-py/tree/master/examples
RedisOM for Python：面向?qū)ο蟮?Redis 客戶(hù)端（文檔模型）
Redis Modules：RedisJSON、RediSearch、RedisGraph 等高級(jí)功能

通過(guò)上述步驟，你已能夠在 Python 應(yīng)用中快速集成并高效使用 Redis。接下來(lái)，可進(jìn)一步探索管道、事務(wù)、發(fā)布/訂閱模式，以及 Redis Streams、Lua 腳本與集群模式等進(jìn)階特性，以滿(mǎn)足更復(fù)雜的業(yè)務(wù)需求。