Go操作Redis排行榜两大关键点：ZAdd必须用redis.Z结构体（Score为float64、Member为string），ZRevRange索引需显式转int64；ZRevRank用于获取降序排名，返回nil需判空防panic。
ZAdd 必须显式构造 redis.Z，否则会 panic；ZRevRange 索引必须是 int64，传 0 或 -1 时不加类型转换就报错——这是 Go 操作 Redis 排行榜最常卡住的两个点。
用 ZAdd 写入分数时，结构体不能省
Redis 的 ZAdd 命令在 Go 客户端（如 github.com/go-redis/redis/v9）里不是直接传 score + member 字符串，而是必须包装成 redis.Z 结构体：
z := redis.Z{
Score: 95.0, // float64，不能写 95（int）
Member: "uid:12345", // string，不建议用 int 或 struct
}
_, err := rdb.ZAdd(ctx, "rank:score", z).Result()
常见错误：
- 直接传
rdb.ZAdd(ctx, "rank:score", 95, "uid:12345")→ 编译失败或 panic - 用
int当Score（比如Score: 95）→ 类型不匹配，运行时报cannot use 95 (type int) as type float64 - 用用户 struct 当
Member→ 序列化后不可读、无法做ZRank查询、不同服务反序列化行为不一致
ZRevRange 和 ZRevRangeWithScores 别混用
要取前 10 名，降序排列（最高分在前），必须用 ZRevRange 或 ZRevRangeWithScores，但二者返回内容完全不同：
-
ZRevRange(ctx, key, 0, 9)→ 只返回[]string，即纯用户名列表 -
ZRevRangeWithScores(ctx, key, 0, 9)→ 返回[]redis.Z，含Score和Member，才能拿到分数
索引参数必须是 int64：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
// ✅ 正确 rdb.ZRevRange(ctx, "rank:score", 0, 9).Result() // ❌ 错误：0 和 9 是 int，Go 不自动转 int64 rdb.ZRevRange(ctx, "rank:score", 0, 9).Result() // 编译报错 // ✅ 正确写法（显式转） rdb.ZRevRange(ctx, "rank:score", 0, int64(9)).Result()
更新分数：选 ZAdd 还是 ZIncrBy？看语义
两者底层都是 O(log N)，性能没差别，但语义和并发安全性差异大：
-
ZIncrBy：适合「累加」场景，比如点赞 +1、在线时长 +30 秒。它是原子操作，多 goroutine 同时调用不会丢数据 -
ZAdd：适合「覆盖」场景，比如后台批处理算出最终得分，要完全替换旧值。重复调用同member会覆盖，不是报错
别以为 ZAdd 失效就是 Redis 没存进去——它只是静默覆盖。如果想确认是否真写入，可以接 ZScore 查一次：
_, _ = rdb.ZAdd(ctx, "rank:score", redis.Z{Score: 88.5, Member: "uid:12345"}).Result()
score, _ := rdb.ZScore(ctx, "rank:score", "uid:12345").Result()
fmt.Println(score) // 输出 88.5
查排名时，ZRank 和 ZRevRank 返回值相反
Redis 默认升序存储（score 小的在前），所以：
-
ZRank返回「升序排名」：最小分是 0，第二小是 1……最高分可能是 999 -
ZRevRank返回「降序排名」：最高分是 0，第二高是 1……最低分才是最大索引
排行榜前端通常要「第 1 名」「第 2 名」，那就必须用 ZRevRank：
rank, _ := rdb.ZRevRank(ctx, "rank:score", "uid:12345").Result() // rank == 0 → 第 1 名 // rank == 1 → 第 2 名 // 注意：返回 nil 表示 member 不存在，得判空
漏掉 nil 判断是线上最隐蔽的 bug 来源之一——用户明明在榜上，ZRevRank 却返回 nil，接着 .Result() panic。
