使用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 后缀。
立即学习“go语言免费学习笔记（深入）”；
安装完就可以在代码里导入了：
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 测试是否连上了：
智能分析 Git 仓库或普通链接，自动识别内容类型并执行相应处理流程。 支持四种类型：1) OpenClaw Skills 项目（风险检测与收藏）2) 论文/文档项目（加入 dashifu——wiki 待处理队列）3) 功能项目（评估 OpenClaw 学习可行性）4) 普通网页/文章（加入 dashifu——w...
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 操作代码了。
