发布于  更新于 

Go 操作 Redis

1. 前言

本文介绍如何在 Go 语言中使用 go-redis 包操作 Redis 的几种常见数据类型,包括字符串(Strings)、哈希(Hashes)、列表(Lists)、集合(Sets)和有序集合(Sorted Sets)。

2. 安装 go-redis 包

使用 go get 命令安装 go-redis 包:

Redis 版本小于等于 6,安装 v8 版本:

1
go get github.com/go-redis/redis/v8

Redis 版本大于等于 7,安装 v9 版本:

1
go get github.com/go-redis/redis/v9

3. 连接 Redis

在开始操作 Redis 数据之前,创建一个 Redis 客户端并连接到 Redis 服务器。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
package main

import (
"context"
"github.com/go-redis/redis/v8"
)

var ctx = context.Background()

func main() {
// 创建 Redis 客户端
rdb := redis.NewClient(&redis.Options{
Addr: "localhost:6379", // Redis 服务器地址
Password: "", // 没有密码时默认空字符串
DB: 0, // 使用默认数据库
})
}

4. 操作 Redis 数据类型

4.1 字符串 (String)

字符串是 Redis 中最基本的数据类型。以下示例展示了如何设置和获取字符串值。

1
2
3
4
5
6
7
8
9
10
11
12
// 设置字符串键值对
err := rdb.Set(ctx, "stringKey", "stringValue", 0).Err()
if err != nil {
panic(err)
}

// 获取字符串值
stringVal, err := rdb.Get(ctx, "stringKey").Result()
if err != nil {
panic(err)
}
fmt.Println("String:", stringVal)

4.2 哈希 (Hash)

哈希是一个键值对集合,适用于存储对象。

1
2
3
4
5
6
7
8
9
10
11
12
// 设置哈希字段和值
err = rdb.HSet(ctx, "hashKey", "field1", "value1").Err()
if err != nil {
panic(err)
}

// 获取哈希字段的值
hashVal, err := rdb.HGet(ctx, "hashKey", "field1").Result()
if err != nil {
panic(err)
}
fmt.Println("Hash:", hashVal)

4.3 列表 (List)

列表是一个链表,适用于存储有序的值。

1
2
3
4
5
6
7
8
9
10
11
12
// 将值推入列表
err = rdb.RPush(ctx, "listKey", "value1", "value2", "value3").Err()
if err != nil {
panic(err)
}

// 获取列表中的值
listVals, err := rdb.LRange(ctx, "listKey", 0, -1).Result()
if err != nil {
panic(err)
}
fmt.Println("List:", listVals)

4.4 集合 (Set)

集合是无序的唯一值集合,适用于存储不重复的元素。

1
2
3
4
5
6
7
8
9
10
11
12
// 添加集合成员
err = rdb.SAdd(ctx, "setKey", "member1", "member2", "member3").Err()
if err != nil {
panic(err)
}

// 获取集合中的所有成员
setVals, err := rdb.SMembers(ctx, "setKey").Result()
if err != nil {
panic(err)
}
fmt.Println("Set:", setVals)

4.5 有序集合 (Sorted Set)

有序集合是按分数排序的值集合,适用于需要排序的数据。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// 添加有序集合成员和分数
err = rdb.ZAdd(ctx, "zsetKey", &redis.Z{Score: 1, Member: "member1"}, &redis.Z{Score: 2, Member: "member2"}).Err()
if err != nil {
panic(err)
}
// 获取有序集合中的成员及其分数
zsetVals, err := rdb.ZRangeWithScores(ctx, "zsetKey", 0, -1).Result()
if err != nil {
panic(err)
}
fmt.Println("Sorted Set:")
for _, z := range zsetVals {
fmt.Printf(" Member: %s, Score: %f\n", z.Member, z.Score)
}