geolocation api 权限请求需用户手势触发，https 环境下才有效；ios/android 权限状态判断不可靠，须结合引导文案、系统设置跳转与错误码分场景处理（拒绝/不可用/超时）。
Geolocation API 请求权限失败时没弹窗怎么办
浏览器不会自动弹出位置授权提示，必须由用户主动触发（比如点击按钮），否则 navigator.geolocation.getCurrentPosition 会静默拒绝或直接报错 NotAllowedError。
- 确保调用
getCurrentPosition或watchPosition的上下文是用户手势事件（click、touchend），不能放在mounted、onload或定时器里 - Safari iOS 对“非安全上下文”（HTTP）完全禁用 Geolocation，必须走 HTTPS；部分安卓 WebView 也遵循此规则
- Chrome 84+ 在页面未交互前调用会降级为
PermissionDenied，即使后续用户点了允许，首次调用仍失败——得重试一次
提示文案和 fallback 引导怎么写才不被跳过
用户看到浏览器原生弹窗前，大概率先看到你的自定义提示。这个提示不是可选项，而是必要前置动作；否则 80% 以上用户根本不知道要开什么、在哪开。
- 别写“请开启定位服务”，要具体：
设置 → Safari/Chrome → 定位服务 → 找到本页 → 设为「使用应用期间」 - Android 用户常卡在系统级开关，需额外提醒：
下拉通知栏 → 长按「位置」图标 → 开启 - 避免用“获取位置”这类技术词，改用场景化表达，比如：
“需要知道您附近门店，才能推荐最近的取货点”
判断 permission 状态并区分处理 iOS/Android 行为差异
navigator.permissions.query({name: 'geolocation'}) 在 iOS 上始终返回 prompt（哪怕已拒绝），无法真实反映状态；Android Chrome 则能返回 granted/denied/prompt。
- 不要依赖
query结果做唯一判断，它只适合辅助：返回granted可直接调用；返回denied就别再请求，引导手动设置；返回prompt一律当“未授权”处理 - iOS 用户若之前点过“不允许”，再次调用
getCurrentPosition不会重新弹窗，必须跳转系统设置页——可用window.location.href = 'app-settings:root=Privacy&path=LOCATION'（仅 Safari 有效），或提示长按地址栏刷新后重试 - 某些国产安卓浏览器（如 QQ 浏览器）根本不支持
permissions.query，需用 try/catch + 超时兜底
超时、拒接、无信号这三种失败怎么分别应对
错误回调里的 error.code 是关键，但不同浏览器对同一原因返回的 code 不一致，不能只靠它分支逻辑。
立即学习“前端免费学习笔记（深入）”；
-
error.code === 1（PERMISSION_DENIED）：用户点了“不允许”，或系统级关闭。此时应隐藏加载态，显示引导设置按钮 -
error.code === 2（POSITION_UNAVAILABLE）：常见于飞行模式、关 GPS、室内无信号。提示语别写“定位失败”，改成：“暂时无法确定位置，试试走到窗边或打开 Wi-Fi？” -
error.code === 3（TIMEOUT）：默认 timeout 是 0（无限等待），务必设{timeout: 5000, maximumAge: 30000}；超时后别重试，优先展示城市级默认位置或搜索框
