Golang操作Redis：go-redis使用教程示例

本文是一篇关于Golang操作Redis的入门教程，重点介绍了如何使用go-redis客户端进行开发。首先，文章讲解了go-redis库的安装和导入方法，并演示了如何配置客户端连接参数，以及如何通过Ping命令测试连接的有效性。接着，详细介绍了Set、Get、Del等基本键值操作，并强调了对redis.Nil错误的正确处理方式。此外，还涵盖了HSet、HGet等哈希表操作，以及RPush、LPop等列表操作的示例。最后，文章还提醒开发者注意context的使用、连接池设置、错误处理和序列化等关键问题，帮助读者避免常见的坑，编写出稳定可靠的Redis操作代码。通过本文，读者可以快速上手Golang与Redis的集成，并掌握常用操作和注意事项。

使用Golang操作Redis需掌握安装客户端、建立连接、执行基本命令及处理复杂数据结构。1. 安装go-redis库并导入；2. 使用redis.NewClient配置连接参数并测试连通性；3. 通过Set、Get、Del进行键值操作，注意处理redis.Nil错误；4. 使用HSet、HGet等操作哈希表，RPush、LPop处理列表；5. 注意context使用、连接池设置、错误处理和序列化问题。

用 Golang 操作 Redis 是很多后端开发者的日常需求，尤其在做缓存、队列、计数器等场景时。如果你是初学者，可能会觉得从头开始有点懵。这里以 go-redis 这个主流客户端为例，讲几个你上手时最需要知道的操作方式和注意事项。

安装 go-redis

使用前得先安装这个库。Golang 的模块管理已经很成熟了，直接运行：

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

注意版本号 v9，这是目前的主流版本。导入的时候记得加上 /v9 后缀。

安装完就可以在代码里导入了：

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

别忘了 context，因为 go-redis 的方法大多都需要传一个 context.Context 参数。

建立连接：配置客户端

建立 Redis 客户端其实不难，但有几个参数容易忽略。下面是一个基础示例：

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

这段代码创建了一个指向本地 Redis 实例的客户端。如果是线上环境，地址要改成对应的 IP 和端口。密码如果没设，就保持空字符串。DB 可以根据项目需要切换。

你可以加一个简单的 Ping 测试是否连上了：

ctx := context.Background()
err := rdb.Ping(ctx).Err()
if err != nil {
    panic(err)
}

常用操作：设置、获取、删除键值

连上之后，最常用的就是 Set、Get、Del 这几个操作。

设置键值对

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

第三个参数是过期时间，设为 0 表示永不过期。

获取值

val, err := rdb.Get(ctx, "username").Result()
if err == redis.Nil {
    fmt.Println("Key does not exist")
} else if err != nil {
    panic(err)
} else {
    fmt.Println("Value:", val)
}

注意判断 redis.Nil 错误，这表示 key 不存在，不是真正的错误。

删除键

err = rdb.Del(ctx, "username").Err()
if err != nil {
    panic(err)
}

这些是最基本的操作，适合刚入门时练习使用。

复杂一点的数据结构怎么处理？

Redis 不只是字符串，还有哈希、列表、集合这些类型。go-redis 都支持，只是写法稍有不同。

比如哈希表：

// 存入一个 hash
err := rdb.HSet(ctx, "user:1001", map[string]interface{}{
    "name":  "Alice",
    "age":   25,
    "email": "alice@example.com",
}).Err()

// 读取 hash 中的某个字段
val, err := rdb.HGet(ctx, "user:1001", "name").Result()

// 读取整个 hash
allFields, err := rdb.HGetAll(ctx, "user:1001").Result()

列表操作也类似，用 RPush、LPop 等方法实现队列逻辑。

这类结构在实际项目中经常用于缓存对象或构建消息队列。

几个容易踩坑的地方

• 上下文 context 的使用：每个操作都建议带上 context，尤其是超时控制，否则可能卡死。
• 连接池设置：默认连接池可能不够用，可以在 Options 里调整 PoolSize。
• 错误处理不能偷懒：像 Get 返回的 error 要区分是不是 Nil，而不是简单 if err != nil 就 panic。
• 序列化问题：Redis 存的是字符串，结构体要用 json.Marshal 再存进去，读出来再反序列化。

基本上就这些内容了。掌握了这几个点，就能写出稳定可用的 Redis 操作代码了。

今天关于《Golang操作Redis：go-redis使用教程示例》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于golang,redis,客户端,数据操作,go-redis的内容请关注golang学习网公众号！