5分钟上手StackExchange.Redis.Extensions：安装、配置与快速入门完整指南

5分钟上手StackExchange.Redis.Extensions安装、配置与快速入门完整指南【免费下载链接】StackExchange.Redis.ExtensionsStackExchange.Redis.Extensions is a library that extends StackExchange.Redis, making it easier to work with Redis in .NET applications项目地址: https://gitcode.com/gh_mirrors/st/StackExchange.Redis.ExtensionsStackExchange.Redis.Extensions 是一款专为 .NET 开发者打造的 Redis 扩展库它在官方 StackExchange.Redis 之上封装了对象自动序列化、连接池管理和高层 API让你无需编写繁琐的样板代码即可在 C# 中直接存取复杂对象。只需 5 分钟你就能完成安装、配置并跑通第一个缓存操作。它是什么为什么需要它直接使用 StackExchange.Redis 时每个对象存取都要手动完成序列化 → 存字节 → 反序列化三步走。StackExchange.Redis.Extensions 把这件事变成了一行代码自动序列化任意 .NET 对象直接存取7 种序列化器可选连接池管理内置 LeastLoaded / RoundRobin 两种选路策略规避超时难题生产级能力健康检查、IDistributedCache 适配器、分布式锁、OpenTelemetry全功能覆盖Pub/Sub、Streams、地理空间、Bitmap、HyperLogLog、Lua 脚本核心抽象层定义在 src/core/StackExchange.Redis.Extensions.Core/Abstractions 目录下IRedisDatabase.cs 就是你要打交道最多的接口。一键安装三条命令搞定打开终端在你的项目目录中执行dotnet add package StackExchange.Redis.Extensions.Core dotnet add package StackExchange.Redis.Extensions.System.Text.Json dotnet add package StackExchange.Redis.Extensions.AspNetCore必须装Core核心 API 任意一个序列化器建议装AspNetCoreDI 集成与健康检查。完整包清单见 doc/packages.md。3步配置appsettings.json 与依赖注入第 1 步在appsettings.json中添加 Redis 节点{ Redis: { Password: , AllowAdmin: true, Ssl: false, ConnectTimeout: 5000, Database: 0, Hosts: [ { Host: localhost, Port: 6379 } ], PoolSize: 5 } }第 2 步在Program.cs中绑定配置并注册服务整个接入过程只有两行核心代码var redisConfig builder.Configuration.GetSection(Redis).GetRedisConfiguration(); builder.Services.AddStackExchangeRedisExtensionsSystemTextJsonSerializer(redisConfig);第 3 步完成现在在任何服务中直接注入IRedisDatabase即可使用。 配置项详解参考 doc/configuration/json-configuration.md也支持纯 C# 编程式配置doc/configuration/c-configuration.md。快速上手存取你的第一个复杂对象public class UserService(IRedisDatabase redis) { public async Task Demo() { // 存对象 —— 序列化由库自动完成 await redis.AddAsync(user:1, new User { Name Ugo, Age 38 }); // 取对象 —— 类型自动还原 var user await redis.GetAsyncUser(user:1); // 带过期时间的会话缓存 await redis.AddAsync(session:abc, data, TimeSpan.FromMinutes(30)); // 按通配符搜索键 var keys await redis.SearchKeysAsync(user:*); } }批量写入用AddAllAsync键管理重命名、类型、dump/restore和原子计数器StringIncrement/StringDecrement同样开箱即用。完整用法见 doc/usage/ 目录。序列化器怎么选一张表看清序列化器适用场景特点System.Text.Json大多数项目推荐.NET 原生、零外部依赖Newtonsoft老项目兼容Json.NET 生态无缝衔接MemoryPack极致性能二进制格式速度最快Protobuf跨语言通信强类型、体积小MsgPack / UTF8Json / ServiceStack特定技术栈各有生态选错序列化器不会报错但会直接影响缓存体积与性能——新项目闭眼选 System.Text.Json。实现代码位于 src/serializers/ 下每个序列化器都是独立 NuGet 包。连接池调优告别超时困扰这是该库最实用的特性之一它维护一组ConnectionMultiplexer连接按策略选择负载最低的连接发请求单个超时不会拖垮整个请求队列。PoolSize: 5PoolSize调大 → 抗并发更强但启动时间变长ConnectionSelectionStrategy支持LeastLoaded默认与RoundRobin详细原理与权衡分析见 doc/configuration/connection-pool.md。进阶能力速览掌握基础后这些功能能让你的 Redis 用法再上台阶能力用途文档分布式锁IAsyncDisposable 自动释放告别手动 unlockdoc/distributed-lock.mdPub/Sub 消息类型化订阅 错误处理doc/pubsub.mdRedis Streams消费组、XADD/XREADdoc/streams.md地理空间索引GEOADD / GEOSEARCH / GEODISTdoc/geospatial.md透明压缩GZip、Brotli、LZ4、Zstd 降低带宽doc/compressors.mdIDistributedCache 适配无缝替换微软分布式缓存doc/distributed-cache.mdASP.NET Core 健康检查监控整个连接池doc/health-check.md多实例场景下还支持命名 Redis 客户端与 .NET 8 Keyed DIdoc/multipleServers.md可参考示例项目 samples/StackExchange.Redis.Samples.Web.Mvc/Program.cs 查看完整装配过程。常见问题与下一步Q连接不上 Redis 怎么办先检查Hosts地址端口再确认AllowAdmin是否开启Azure 托管身份需额外配置doc/azure-managed-identity.md。Q支持哪些框架版本.NET Standard 2.1、.NET 8 / 9 / 10兼容 StackExchange.Redis 2.x 与 3.x。下一步学习路径多对象操作 → doc/usage/work-with-multiple-items.mdHash 字段级过期Redis 7.4→ doc/hash-field-expiry.md自定义序列化器 → doc/usage/custom-serializer.md日志与诊断 → doc/logging.md从一条AddAsync开始5 分钟后你的 .NET 应用就拥有了完整的生产级 Redis 能力。【免费下载链接】StackExchange.Redis.ExtensionsStackExchange.Redis.Extensions is a library that extends StackExchange.Redis, making it easier to work with Redis in .NET applications项目地址: https://gitcode.com/gh_mirrors/st/StackExchange.Redis.Extensions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考