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

目前golang学习网上已经有很多关于Golang的文章了，自己在初次阅读这些文章中，也见识到了很多学习思路；那么本文《Golang操作Redis教程：go-redis客户端使用示例》，也希望能帮助到大家，如果阅读完后真的对你学习Golang有帮助，欢迎动动手指，评论留言并分享~

使用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学习网公众号也会发布Golang相关知识，快来关注吧！