应使用 github.com/go-redis/redis/v9，它活跃维护、支持 Go Modules 且强制传 context；需用 redis.NewClient() 创建实例，避免旧版导入和全局单例，所有命令必须带超时 context。
直接用 github.com/go-redis/redis/v9，别碰 v8 或更老版本——v9 是当前唯一活跃维护、支持 Go Modules 且默认启用上下文取消的版本。
安装正确的 Redis 客户端库
v9 版本已彻底移除全局客户端单例设计，强制使用 redis.NewClient() 构造带生命周期管理的实例。常见错误是沿用 v7/v8 的 redis.Dial() 或误导入 github.com/go-redis/redis（无版本后缀）导致模块解析失败或类型不兼容。
- 运行
go get github.com/go-redis/redis/v9，确保go.mod中出现github.com/go-redis/redis/v9 v9.x.x - 不要
go get github.com/go-redis/redis—— 这会拉取未打 v8 tag 的旧 master 分支，与文档严重脱节 - 如果项目里已有
gopkg.in/redis.v5等老路径，必须全量替换 import 路径和函数调用方式
初始化 Client 并传入 Context
v9 所有命令都要求显式传入 context.Context，没有默认超时，不传或传 context.Background() 可能导致连接卡死或 goroutine 泄漏。
- 推荐在启动时创建 client：
client := redis.NewClient(&redis.Options{Addr: "localhost:6379", Password: "", DB: 0}) - 务必检查
client.Ping(context.WithTimeout(context.Background(), 3*time.Second)).Err()是否为 nil，否则后续调用全失败 - 避免在 handler 中反复调用
NewClient()—— 连接池由 client 内部维护，复用一个 client 实例即可
处理常见连接错误：timeout / connection refused / no such host
这些不是代码 bug，而是环境配置问题，优先排查本地 Redis 服务状态和网络可达性。
立即学习“go语言免费学习笔记（深入）”；
-
dial tcp [::1]:6379: connect: connection refused→ Redis 没启动，运行redis-server或docker run -d -p 6379:6379 --name myredis redis -
redis: connection closed或超时 → 检查Addr是否写成"127.0.0.1:6379"（某些 macOS/Docker 环境下localhost解析异常） - 使用 Docker Compose 时，service 名不能写
localhost，应填容器名如redis:6379
读写操作必须带 context，且建议设超时
v9 不再提供无 context 的方法签名，硬编码 context.Background() 在 HTTP handler 中极易引发请求堆积；没设超时则可能阻塞整个 goroutine。
- 正确写法：
ctx, cancel := context.WithTimeout(r.Context(), 500*time.Millisecond); defer cancel() - 然后调用
client.Set(ctx, "key", "value", 0).Err()，而非client.Set(context.Background(), ...) - 注意
0表示永不过期，若要设置过期时间，传time.Minute * 10这类time.Duration
真正麻烦的不是连不上 Redis，而是连上了却忘了传 context 或设 timeout，结果线上 goroutine 数缓慢上涨，直到 OOM。v9 的设计就是逼你直面并发控制——这点没法绕开。
