geohash编码需先确认经纬度顺序为lat,lng且范围在[-90,90]和[-180,180]内，推荐用uint64做邻近计算、string存redis，避免直接用hash字符串等值匹配，因geohash表示区域而非精确点。
用 geohash.Encode 编码前，先确认经纬度顺序和范围
Go 里几乎所有主流 GeoHash 库（比如 github.com/mmcloughlin/geohash）都要求参数顺序是 lat, lng（纬度在前，经度在后），不是地图 API 常见的 lng, lat。传反了坐标会偏到南美洲甚至南极——而且不会报错，只会静默编码出错的位置。
- 纬度必须在
[-90, 90]范围内；超出会 panic 或返回无效值（如NaN） - 经度必须在
[-180, 180]；Redis 的 GEO 命令还额外限制纬度不能超过 ±85.05112878（WGS84 投影上限），但纯 Go 编码不强制这一条 - 如果数据来自前端
Geolocation API或高德/百度 SDK，务必检查它们返回的字段名和顺序——coords.longitude是经度，coords.latitude是纬度
示例：
import "github.com/mmcloughlin/geohash"<br><br>// ✅ 正确：纬度 39.9086，经度 116.3974<br>hash := geohash.Encode(39.9086, 116.3974)<br><br>// ❌ 错误：顺序颠倒，结果可能是 "w2f1s0j0n0" —— 实际指向西非某处
选字符串还是 uint64？看你是存 Redis 还是做内存计算
GeoHash 本质是把二维坐标映射成一维标量，Go 库普遍支持两种输出形式：string（Base32 编码，如 "wx4g0b"）和 uint64（64 位整数，如 0x1a2b3c4d5e6f7890）。选哪个，取决于你下一步怎么用。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 存 Redis 的
GEOADD：必须用string，因为 Redis GEO 命令只认字符串格式的 GeoHash（底层虽用 double 存 score，但命令接口不暴露整数编码） - 做邻近区域计算（比如找 8 个邻居）：优先用
uint64，库内部运算更快，且邻居函数（如Neighbours()）通常直接操作整数编码 - 精度控制：字符串长度决定误差，
len("wx4g") == 4对应约 ±19km；len("wx4g0b") == 6约 ±1.2km。用EncodeWithPrecision(lat, lng, 6)比手动截断字符串更安全
GeoRadius 类查询在 Go 里别自己算距离，直接调 Redis 命令
有人想“既然我有 GeoHash 字符串，不如自己解码 + Haversine 公式算距离”，这完全没必要，也容易翻车。Redis 的 GEORADIUS 和 GEORADIUSBYMEMBER 已经封装了完整的球面距离计算（Haversine）、边界框预筛、ZSET 范围扫描逻辑，且经过十年以上生产验证。
- Go 客户端（如
github.com/redis/go-redis/v9）调用简单：client.GeoRadius(ctx, "user_locations", 116.3974, 39.9086, &redis.GeoRadiusQuery{Radius: 5, Unit: "km"}) - 注意单位参数必须小写：
"m"或"km"，传"KM"会返回空结果，无错误提示 - 如果要带坐标、距离、hash 一起返回，加
WithCoord: true,WithDist: true等选项，避免后续再查GEODIST或GEOPOS
精度陷阱：相同 GeoHash 字符串 ≠ 相同地理位置
GeoHash 是矩形区域编码，不是点编码。一个 "wx4g0b" 表示的是一个经纬度范围（比如东经 116.39–116.40，北纬 39.90–39.91），区域内任意点都共享该 hash。这意味着：
- 两个用户坐标差 10 米，但落在相邻矩形里，hash 可能完全不同（边界突变问题）
- 用
GEORADIUS查 500 米内用户时，Redis 会自动查目标点所在 hash 及其 8 个邻居 hash 对应的 ZSET 区间，再逐个算真实距离过滤——这是它能快速的原因，也是你不能跳过 Redis 直接用 hash 字符串做等值匹配的理由 - 如果业务强依赖“精确邻近”，比如社交 App 的“附近 500 米陌生人”，建议在 Redis 返回结果后，再用 Go 调
geohash.Distance()做二次校验（尤其当COUNT设得较大时）
边界突变没法根除，但可以缓解：提高精度（用 7–8 位 hash）、或改用 Hilbert 曲线编码库（如 github.com/tidwall/hilbert），不过代价是生态支持弱、Redis 不兼容。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
