### 使用 Python 操作 Redis 的基本教程 #### 1. 安装 `redis-py` 库 为了在 Python 中操作 Redis，需要安装 `redis-py` 库。可以通过以下命令完成安装： ```bash pip install redis ``` 此步骤确保可以成功导入并使用 Redis 功能[^1]。 --- #### 2. 连接到 Redis 数据库 通过 `redis.Redis()` 方法建立与 Redis 实例的连接。以下是连接代码示例： ```python import redis # 创建 Redis 连接对象，默认本地主机和默认端口 conn = redis.StrictRedis(host='localhost', port=6379, decode_responses=True) # 测试连接是否正常 if conn.ping(): print("Connected to Redis successfully!") else: print("Failed to connect to Redis.") ``` 上述代码中设置了参数 `decode_responses=True`，以便返回的结果自动解码为字符串形式[^2]。 --- #### 3. 基本 CRUD 操作 ##### (1) **创建/更新键值对** 向 Redis 添加新的键值对或者修改已存在的键值对： ```python # 设置单个键值对 conn.set('name', 'Alice') # 批量设置多个键值对 conn.mset({'age': 25, 'city': 'Beijing'}) # 获取指定键的值 print(conn.get('name')) # 输出: Alice ``` ##### (2) **查询键值对** 检索 Redis 中存储的数据： ```python # 查询单个键的值 value = conn.get('age') print(value) # 输出: 25 # 查询多个键的值 values = conn.mget(['name', 'city']) print(values) # 输出: ['Alice', 'Beijing'] ``` ##### (3) **删除键值对** 移除 Redis 中的一个或多个键及其对应值： ```python # 删除单个键 conn.delete('age') # 删除多个键 conn.delete('name', 'city') ``` ##### (4) **遍历所有键** 获取当前数据库中的所有键名： ```python all_keys = conn.keys('*') print(all_keys) # 返回所有匹配模式 '*' 的键列表 ``` ##### (5) **高级数据结构操作** ###### a. 列表（List） ```python # 向列表右侧追加元素 conn.rpush('my_list', 'item1', 'item2', 'item3') # 查看整个列表的内容 items = conn.lrange('my_list', 0, -1) print(items) # 输出: ['item1', 'item2', 'item3'] # 移除第一个匹配项 conn.lrem('my_list', 1, 'item2') ``` ###### b. 集合（Set） ```python # 将成员加入到集合中 conn.sadd('my_set', 'apple', 'banana', 'cherry') # 获取集合内的所有成员 members = conn.smembers('my_set') print(members) # 输出: {'apple', 'banana', 'cherry'} # 删除某个成员 conn.srem('my_set', 'banana') ``` ###### c. 哈希（Hash） ```python # 存储哈希字段及对应的值 conn.hset('user_profile', mapping={'username': 'JohnDoe', 'email': 'john@example.com'}) # 获取特定字段的值 email = conn.hget('user_profile', 'email') print(email) # 输出: john@example.com # 删除某字段 conn.hdel('user_profile', 'email') ``` --- #### 4. 错误处理 在实际开发过程中，可能会遇到网络异常或其他错误情况。建议添加异常捕获机制来增强程序稳定性： ```python try: result = conn.get('non_existent_key') except redis.exceptions.ConnectionError as e: print(f"Connection error occurred: {e}") except Exception as ex: print(f"An unexpected error occurred: {ex}") ``` --- ### 总结 以上介绍了如何利用 Python 和 `redis-py` 库实现 Redis 的连接、基础增删改查功能以及部分复杂数据类型的使用方法[^3][^4]。这些技能能够帮助开发者快速上手基于 Redis 的应用开发。