go-redis 是一个 Go 语言实现的 Redis 客户端，功能强大、易于使用，能够帮助 Go 开发者与 Redis 数据库进行高效的交互。它支持 Redis 的所有主要功能，并且提供了许多高级功能，如管道操作、事务、发布/订阅模式、集群支持等。
安装 go-redis 非常简单，可以通过 go get 安装：
Life is like a journey
go get github.com/go-redis/redis/v8
v8 是目前稳定版本，因此推荐使用这个版本。
在使用 go-redis 前，你需要先连接到 Redis 服务器。以下是一个简单的示例：
package main
import (
"context"
"fmt"
"log"
"github.com/go-redis/redis/v8"
)
var ctx = context.Background()
func main() {
// 创建一个 Redis 客户端
client := redis.NewClient(&redis.Options{
Addr: "localhost:6379", // Redis 地址
DB: 0, // 默认使用数据库 0
})
// 测试连接
pong, err := client.Ping(ctx).Result()
if err != nil {
log.Fatalf("Error connecting to Redis: %v", err)
}
fmt.Println(pong) // Output: PONG
// 设置一个键值对
err = client.Set(ctx, "name", "John", 0).Err()
if err != nil {
log.Fatalf("Error setting value: %v", err)
}
// 获取一个键的值
val, err := client.Get(ctx, "name").Result()
if err != nil {
log.Fatalf("Error getting value: %v", err)
}
fmt.Println("name:", val) // Output: name: John
}
redis.NewClient() 用于创建一个 Redis 客户端连接。client.Ping() 用来检查与 Redis 的连接是否成功。client.Set() 用来设置一个键值对。client.Get() 用来获取一个键的值。err := client.Set(ctx, "key", "value", 0).Err()
if err != nil {
log.Fatalf("Error setting key: %v", err)
}
client.Set(ctx, "key", "value", 0) 用于设置一个键值对。第三个参数是过期时间，0 表示没有过期时间。val, err := client.Get(ctx, "key").Result()
if err != nil {
log.Fatalf("Error getting key: %v", err)
}
fmt.Println("key:", val)
client.Get(ctx, "key").Result() 用来获取键值 key 对应的值。err := client.Del(ctx, "key").Err()
if err != nil {
log.Fatalf("Error deleting key: %v", err)
}
client.Del(ctx, "key").Err() 用来删除一个键。exists, err := client.Exists(ctx, "key").Result()
if err != nil {
log.Fatalf("Error checking if key exists: %v", err)
}
fmt.Println("Key exists:", exists)
client.Exists(ctx, "key").Result() 返回键是否存在。管道操作（Pipeline）允许你一次发送多个 Redis 命令，而不需要等待每个命令的响应，从而提高了性能。go-redis 支持管道操作。
pipe := client.Pipeline()
// 使用管道执行多个命令
pipe.Set(ctx, "name", "John", 0)
pipe.Set(ctx, "age", 30, 0)
// 执行管道命令
_, err := pipe.Exec(ctx)
if err != nil {
log.Fatalf("Error executing pipeline: %v", err)
}
client.Pipeline() 创建一个管道对象。pipe.Set() 用于将多个命令添加到管道中。pipe.Exec() 执行所有管道中的命令。Redis 提供了发布/订阅模式（Pub/Sub），go-redis 也支持这一功能，允许你进行消息的发布和订阅。
pubsub := client.Subscribe(ctx, "mychannel")
defer pubsub.Close()
// 等待消息
msg, err := pubsub.ReceiveMessage(ctx)
if err != nil {
log.Fatalf("Error receiving message: %v", err)
}
fmt.Println("Received message:", msg.Payload)
client.Subscribe(ctx, "mychannel") 用来订阅一个频道。pubsub.ReceiveMessage(ctx) 用来接收频道上的消息。err := client.Publish(ctx, "mychannel", "Hello, Redis!").Err()
if err != nil {
log.Fatalf("Error publishing message: %v", err)
}
client.Publish(ctx, "mychannel", "message") 用来向指定的频道发布消息。go-redis 也支持 Redis 事务操作。你可以通过 MULTI 和 EXEC 命令来处理事务。
// 开始一个事务
tx := client.TxPipeline()
// 在事务中执行命令
tx.Set(ctx, "name", "Alice", 0)
tx.Incr(ctx, "counter")
// 执行事务
_, err := tx.Exec(ctx)
if err != nil {
log.Fatalf("Error executing transaction: %v", err)
}
client.TxPipeline() 用于开始一个事务。tx.Set()、tx.Incr() 等方法在事务中执行命令。tx.Exec() 提交事务。go-redis 支持 Redis 集群。如果你使用 Redis 集群而非单个 Redis 实例，可以使用以下代码连接到 Redis 集群：
clusterClient := redis.NewClusterClient(&redis.ClusterOptions{
Addrs: []string{"localhost:7000", "localhost:7001", "localhost:7002"},
})
pong, err := clusterClient.Ping(ctx).Result()
if err != nil {
log.Fatalf("Error connecting to Redis cluster: %v", err)
}
fmt.Println(pong) // Output: PONG
redis.NewClusterClient() 用于连接到 Redis 集群。clusterClient.Ping() 用于检查与 Redis 集群的连接。go-redis 还支持执行 Lua 脚本，可以用来执行一些复杂的 Redis 操作。
script := redis.NewScript(`
local key = KEYS[1]
local value = ARGV[1]
return redis.call('GET', key)
`)
val, err := script.Run(ctx, client, []string{"key"}, "value").Result()
if err != nil {
log.Fatalf("Error running Lua script: %v", err)
}
fmt.Println("Lua script result:", val)
redis.NewScript() 用于创建一个 Lua 脚本。script.Run() 用于执行该 Lua 脚本。go-redis 支持 Redis 4.x 及更高版本。它支持 Redis 的几乎所有常用功能，包括 Redis 的数据类型（如字符串、哈希、列表、集合、有序集合）和各种操作（如 SET, GET, HSET, HGET 等）。
go-redis 内部实现了连接池机制，以优化与 Redis 的连接性能。它会自动管理连接，避免每次操作时都要重新建立连接。
go-redis 是一个功能齐全且高效的 Redis 客户端库，提供了对 Redis 各种功能的完整支持，包括简单的键值操作、事务、发布/订阅、管道操作、Lua 脚本等。它的易用性和灵活性使得它成为 Go 开发者在与 Redis 交互时的首选库。
go-redis 是处理 Redis 数据库操作时一个非常流行和强大的工具，适合用于各种场景，从简单的缓存管理到复杂的实时消息传递系统。