使用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 的各种数据类型，比如字符串、哈希、列表、集合等，而且也支持连接池、集群、哨兵模式等高级特性。
立即学习“go语言免费学习笔记（深入）”；
连接 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 打配合了。
