在 .net aspire 中集成 redis 的核心步骤是：安装 aspire.hosting.redis 包、调用 addredis("cache") 注册资源、在业务项目中通过 withreference(cache) 和 getconnectionstring("cache") 注入引用；全程无需手动处理连接字符串或 connectionmultiplexer。
直接说结论：在 .NET Aspire 里集成 Redis，核心就三步——装包、注册资源、注入引用；不是写连接字符串，也不是手动 new ConnectionMultiplexer。
要先装 Aspire.Hosting.Redis 包
Aspire 的 Redis 集成不是开箱即用的，必须显式引入 NuGet 包。不装这个，AddRedis 方法根本不存在，编译直接报错：The name 'AddRedis' does not exist in the current context。
- 推荐用 CLI 命令（在 AppHost 项目目录下运行）：
dotnet add package Aspire.Hosting.Redis - 或者用 Aspire CLI（更智能）：
aspire add redis，它会自动选中Aspire.Hosting.Redis并确认版本 - 别误装
StackExchange.Redis—— 那是运行时客户端库，Aspire 编排层不需要它
AddRedis("cache") 是声明式资源，不是连接初始化
这行代码不会立刻连上 Redis，也不会抛出连接异常；它只是告诉 Aspire：“本地开发时，请拉起一个 Redis 容器，并把它命名为 cache”。实际容器启动、端口映射、健康检查都由 Aspire 自动完成。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 默认行为：启动官方
redis:alpine镜像，监听 6379，无密码 - 想连已有 Redis？改用
.AsExisting()：builder.AddRedis("cache").AsExisting("localhost:6379") - 需要 RedisInsight 管理界面？链式调用：
.WithRedisInsight()，启动后访问http://localhost:8001（端口可配） - 名字（如
"cache"）会成为服务发现名，下游项目通过它引用，不是连接字符串的一部分
业务项目里不用管连接字符串，WithReference(cache) 就够了
你在 API 或 Worker 项目中，完全不需要读取配置、拼接 host:port、处理密码或 SSL。Aspire 已把连接信息注入为环境变量和 IConfiguration。
- 只要在 AppHost 中写了：
builder.AddProject<projects.apiservice>().WithReference(cache)</projects.apiservice> - 那
ApiService项目启动时，就能通过builder.Configuration.GetConnectionString("cache")拿到完整连接串（如localhost:12345，注意：端口是 Aspire 动态分配的，不是 6379） - 如果你用的是
StackExchange.Redis，直接传这个连接串给ConnectionMultiplexer.Connect()即可，无需额外解析 - 别手写
"localhost:6379"—— 本地开发和 Azure 部署时地址完全不同，硬编码会导致部署失败
部署到 Azure 时要换包和方法
本地用 AddRedis 启容器，上云就得切到托管服务。Azure Cache for Redis 不是你能随便启容器的，必须用专用集成。
- 卸载
Aspire.Hosting.Redis，安装Aspire.Hosting.Azure.Redis - 把
AddRedis("cache")改成AddAzureRedis("cache") - 该方法会生成 ARM/Bicep 模板，预配真实 Azure Cache 实例，而非容器
- 连接串依然通过
GetConnectionString("cache")获取，业务代码零修改 —— 这才是 Aspire “同一份代码，多环境部署”的关键
最容易被忽略的一点：Aspire 的 Redis 资源名（如 "cache"）必须和业务项目里 GetConnectionString() 的参数名严格一致，大小写敏感，且不能含特殊字符。拼错一个字母，连接串就是 null，但不会报错，只会静默失败。
