geosearch比georadius更推荐，因其是redis 6.2+官方指定替代命令，支持frommember免rtt查坐标、bybox矩形搜索（georadius不支持），且go客户端中单位语义统一（radius固定为米），避免单位混淆导致的查询失败。

为什么GEOSEARCH比GEORADIUS更推荐

因为GEOSEARCH是Redis 6.2+官方明确标记为“替代GEORADIUS/GEORADIUSBYMEMBER”的新命令，不是功能增强，而是设计重构——它解决了旧命令长期存在的语义割裂、能力缺失和客户端适配混乱问题。

GEOSEARCH支持FROMMEMBER，GEORADIUS做不到

GEORADIUS只能接受经纬度坐标作为中心点，如果想以某个已存用户（比如“u123”）为圆心查附近的人，必须先调用GEOPOS取坐标，再拼GEORADIUS，两轮RTT且易出错。而GEOSEARCH原生支持FROMMEMBER参数：

GEOSEARCH users:geo FROMMEMBER u123 BYRADIUS 500 m WITHDIST ASC COUNT 10

这在社交类、骑手调度等场景中省掉一次网络往返，也避免了坐标精度丢失或并发更新导致的坐标漂移。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

BYBOX矩形搜索是GEORADIUS完全缺失的能力

很多真实业务不适用圆形：地图瓦片加载、行政区划筛选、POI网格热力图、共享单车电子围栏，都需要矩形范围。GEORADIUS只支持BYRADIUS，硬凑矩形得用4次半径查询再去重，性能差还漏边角。而GEOSEARCH直接支持：

• BYBOX 2000 1500 m：宽2km、高1.5km的矩形，左下角为查询原点
• 单位只认小写m/km/ft/mi，Unit字段在Go客户端里已被移除
• 矩形搜索内部仍基于GeoHash网格，但会自动覆盖相邻9格，保证边界完整性

Go客户端里Unit和Radius单位处理差异极大

这是最常踩的坑：用github.com/redis/go-redis/v9时，两个命令对单位的约定完全不同：

• client.GeoRadius：Radius字段是数值，Unit必须显式传字符串，比如Unit: "km"；写成"KM"或漏传，直接报ERR unknown unit
• client.GeoSearch：Radius字段单位**固定为米**，Unit参数已废弃；传Radius: 1000就是1000米，传Radius: 1就是1米——别再想“加个km后缀”
• 同样传10，GeoRadius默认按米算（隐式），GeoSearch就真是10米；没意识到这点，查不到结果时根本不会怀疑单位

矩形搜索没有单位歧义，BYBOX width height unit里的unit仍需小写，但至少width和height数值含义清晰，不像半径容易被误读为“公里数”。