Geolocation API 是浏览器原生接口，非 JavaScript 内置函数，需 HTTPS 或 localhost 安全上下文、用户授权及设备支持；常见失败原因包括非安全环境、权限拒绝、功能禁用或无定位能力。
Geolocation API 本身不是 JavaScript 的内置函数，而是浏览器原生提供的接口，navigator.geolocation 是它的入口对象；它不能“直接获取位置”，必须由用户主动授权，且只在安全上下文（https 或 localhost）中可用。
为什么调用 navigator.geolocation.getCurrentPosition() 没反应或报错
最常见的原因是环境不满足强制前提：
- 页面未通过 HTTPS 提供服务（生产环境）或非
localhost（开发时用127.0.0.1也不行，必须是localhost） - 用户已永久拒绝地理位置权限，此时不会弹出授权框，
getCurrentPosition()会直接进入 error 回调，error.code通常是1（PERMISSION_DENIED） - 浏览器禁用了该功能（如某些企业策略、隐私模式下默认关闭）
- 设备无定位能力（如台式机没 GPS、Wi-Fi 关闭且没启用 IP 定位）
检查是否就绪可先写一行判断：
if (!navigator.geolocation) {
console.error('当前浏览器不支持 Geolocation API');
}
getCurrentPosition() 和 watchPosition() 怎么选
两者都依赖用户授权，但用途差异明显：
立即学习“Java免费学习笔记（深入）”；
GitHub操作助手
下载
用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
-
getCurrentPosition()：只获取一次当前位置，适合「签到」「附近搜索」这类单次动作 -
watchPosition()：持续监听位置变化，返回一个唯一watchId，可用于导航、运动轨迹记录；但必须手动调用navigator.geolocation.clearWatch(watchId)停止，否则可能持续耗电
二者参数结构一致，第二参数（error 回调）不可省略——即使你只想处理成功逻辑，也得显式传入空函数或至少 () => {}，否则出错时静默失败。
获取到的 position.coords 里哪些字段可靠
不同设备/网络环境下，精度差异极大。关键字段可靠性如下：
-
latitude/longitude：始终存在（哪怕只是粗略 IP 定位），可放心使用 -
accuracy：单位米，表示经纬度误差半径；10表示高精度（GPS），1000+表示仅靠 Wi-Fi 或基站估算 -
altitude/altitudeAccuracy：桌面浏览器极少提供，移动端部分 Android 设备可能为null -
heading/speed：仅当设备在移动且有方向传感器时才有效，静态场景下通常为NaN
不要假设所有字段都有值，读取前务必做 typeof position.coords.xxx !== 'undefined' 或空值检查。
实际项目中，最易被忽略的是错误处理粒度——比如把 error.code === 2（POSITION_UNAVAILABLE）当成临时失败重试，但它往往意味着设备根本无法获取任何定位源，重试毫无意义。权限、网络、硬件三者缺一不可，少一个环节就卡死。
