Golang操作Redis实战教程

使用Golang操作Redis需选对库并写好代码结构，具体步骤如下：1.安装go-redis库，使用go get命令获取；2.连接Redis服务器，通过redis.NewClient创建客户端实例并测试连接；3.执行常见操作，包括字符串的设置与获取、哈希存储对象、列表用于队列场景；4.注意上下文使用、错误处理、连接池配置及性能优化等关键点。掌握这些即可高效实现Golang与Redis的协作。

Golang操作Redis其实并不难，关键在于选对库、写对代码结构。目前最常用的Redis客户端是go-redis，它功能齐全、文档完善，社区活跃度也高。下面我们就来一步步看看怎么用Golang连接和操作Redis。

安装 go-redis 库

在开始写代码之前，首先需要安装 Redis 的 Go 客户端。使用 go get 命令安装即可：

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

这个库支持 Redis 的各种数据类型，比如字符串、哈希、列表、集合等，而且也支持连接池、集群、哨兵模式等高级特性。

连接 Redis 服务器

连接 Redis 是最基本的操作。通常我们会使用 redis.NewClient 方法创建一个客户端实例。

示例代码如下：

package main

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

var ctx = context.Background()

func main() {
    rdb := redis.NewClient(&redis.Options{
        Addr:     "localhost:6379", // Redis 地址
        Password: "",               // 密码（如果没有可以留空）
        DB:       0,                // 使用默认数据库
    })

    // 测试是否连接成功
    _, err := rdb.Ping(ctx).Result()
    if err != nil {
        panic("failed to connect redis")
    }

    fmt.Println("Connected to Redis!")
}

这里有几个细节需要注意：

• Addr 要根据你的实际 Redis 服务地址填写；
• 如果 Redis 设置了密码，别忘了填上；
• Ping 是测试连接是否正常的常用方式。

常见操作：字符串、哈希、列表

连接成功之后，就可以进行各种操作了。下面列举几个常见的 Redis 操作示例：

字符串操作

设置和获取字符串是最简单的操作：

err := rdb.Set(ctx, "name", "Tom", 0).Err()
if err != nil {
    panic(err)
}

val, err := rdb.Get(ctx, "name").Result()
if err != nil {
    panic(err)
}
fmt.Println("name:", val)

• Set 第三个参数是过期时间，0 表示永不过期；
• Get 返回的是字符串值。

哈希操作

哈希适合存储对象：

err := rdb.HSet(ctx, "user:1001", map[string]interface{}{
    "name":  "Jerry",
    "age":   25,
    "email": "jerry@example.com",
}).Err()
if err != nil {
    panic(err)
}

result := rdb.HGetAll(ctx, "user:1001").Val()
fmt.Println(result)

• HSet 可以一次设置多个字段；
• HGetAll 获取整个 hash 的内容。

列表操作

列表常用于消息队列等场景：

rdb.RPush(ctx, "queue", "task1").Err()
rdb.RPush(ctx, "queue", "task2").Err()

tasks := rdb.LRange(ctx, "queue", 0, -1).Val()
fmt.Println(tasks)

// 取出并删除第一个元素
task := rdb.LPop(ctx, "queue").Val()
fmt.Println("Popped task:", task)

• RPUSH 往右边添加元素；
• LPOP 从左边取出一个元素。

注意事项与常见问题

在实际开发中，有些点容易被忽略：

• 上下文 Context 的使用：几乎每个方法都需要传入 context，推荐统一使用 background 或者从 HTTP 请求中传入；
• 错误处理要到位：每次调用 Redis 都可能失败，尤其是网络原因，建议统一封装或记录日志；
• 连接池配置：生产环境应合理设置最大连接数，避免资源耗尽；
• 性能优化：对于高频读写，可以考虑 Pipeline 批量操作，减少网络往返次数；

例如，连接池配置可以这样设置：

rdb := redis.NewClient(&redis.Options{
    Addr:         "localhost:6379",
    Password:     "",
    DB:           0,
    PoolSize:     10,  // 连接池大小
    MinIdleConns: 5,   // 最小空闲连接数
})

基本上就这些。掌握这几个基本操作，再结合项目需求，你就能轻松用 Golang 和 Redis 打配合了。