HTML5 Geolocation API 依赖底层系统且需 HTTPS/localhost 环境；失败主因是权限拒绝、定位服务关闭或超时未设；须完整处理 error 回调并适配坐标系与设备兼容性。
HTML5 的 Geolocation API 本身不直接“定位”，它只是请求浏览器调用底层系统（如 GPS、Wi-Fi、IP 地址）提供的位置数据；能否拿到准确坐标，取决于用户授权、设备能力、环境信号和浏览器实现。
为什么 navigator.geolocation.getCurrentPosition() 经常失败或返回超时？
这是最常见问题，不是代码写错了，而是权限或环境没到位：
- 页面必须运行在
https://或localhost下（HTTP 协议下 Chrome/Firefox 会静默拒绝） - 用户第一次访问时弹出的权限提示被手动拒绝，后续调用会直接进
error回调，且不会再次弹窗——需引导用户去浏览器地址栏点击锁形图标手动开启 -
timeout默认是无穷大，建议显式设为5000（5 秒），否则在弱网或无 GPS 设备上卡住不动 - 部分安卓 WebView 或旧版 iOS Safari 对
enableHighAccuracy: true支持不稳定，开启后反而更慢或失败
如何正确处理 getCurrentPosition() 的 success 和 error 回调？
别只写 success，error 回调必须覆盖所有标准错误码，并给出用户可理解的反馈：
-
error.code === 1：用户拒绝授权 → 提示“请在浏览器地址栏点击锁图标，允许本页获取位置” -
error.code === 2：位置服务不可用（如关机、飞行模式、GPS 关闭）→ 提示“请检查设备定位功能是否已开启” -
error.code === 3：请求超时 → 可尝试降级：再调一次，去掉enableHighAccuracy，或改用 IP 粗略定位（需后端配合） - 成功回调里的
position.coords.latitude和position.coords.longitude是 WGS84 坐标系，国内地图（如高德、腾讯）需注意是否要转火星坐标系（GCJ-02）
要不要用 navigator.geolocation.watchPosition()？
仅当业务真正需要持续追踪时才用，比如导航、运动轨迹记录。它不是“更准的 getCurrentPosition”，而是不断触发回调：
立即学习“前端免费学习笔记（深入）”；
- 每次触发都可能返回不同精度的坐标（比如从 IP 定位跳到 GPS 定位），需自己做平滑或过滤（如丢弃
accuracy > 50的点） - 必须保存
watchId，并在不需要时调用navigator.geolocation.clearWatch(watchId)，否则内存泄漏 + 持续耗电 - 移动端后台运行时，多数浏览器会暂停
watchPosition，不要依赖它做后台打卡类逻辑
真正难的不是调用 API，而是应对各种拒绝、超时、精度跳变、坐标系偏差和浏览器兼容性抖动。上线前务必在真机（尤其低端安卓）+ 多种网络环境下实测，别只信开发机上的 localhost 结果。
