navigator.geolocation 在非HTTPS、旧浏览器或权限禁用时为undefined；需先检测存在性，再调用getCurrentPosition()并传入success、error及options参数（含enableHighAccuracy、timeout、maximumAge）；可用watchPosition()监听变化，但受节流和后台暂停限制；移动端需注意iOS手势触发、Android WebView配置及X5内核兼容问题。
为什么 navigator.geolocation 有时返回 undefined 或报错
不是所有环境都支持地理定位，navigator.geolocation 在非 HTTPS 页面、某些旧版浏览器（如 IE9 及以下）、或用户禁用位置权限时会不可用。直接调用 getCurrentPosition() 前必须先检查是否存在：
if (!navigator.geolocation) {<br> console.error('当前浏览器不支持地理位置');<br> return;<br>}注意：即使存在，也**不保证一定能获取成功**——用户拒绝授权、GPS 未开启、网络定位失败都会触发 error 回调。
getCurrentPosition() 的三个参数怎么填才不踩坑
这个方法接受三个参数：success、error 和可选的 options。最容易忽略的是第三个参数——它控制精度、超时和是否强制使用高精度设备：
-
enableHighAccuracy: true会尝试用 GPS（耗电、慢），但多数移动浏览器默认为false，仅用 Wi-Fi/基站粗略定位 -
timeout: 5000单位是毫秒，不设可能卡住几秒甚至更久 -
maximumAge: 60000表示可接受 1 分钟内缓存的位置，避免重复请求
getCurrentPosition(success)（没传 error，出错就静默失败）；推荐写法：navigator.geolocation.getCurrentPosition(<br> (pos) => console.log(pos.coords.latitude, pos.coords.longitude),<br> (err) => console.warn('定位失败:', err.code, err.message),<br> { enableHighAccuracy: false, timeout: 8000, maximumAge: 30000 }<br>);
如何监听位置变化而不是只取一次
用 watchPosition() 替代 getCurrentPosition()，它返回一个 watchId，可用于后续取消监听：
const watchId = navigator.geolocation.watchPosition(<br> (pos) => updateMap(pos.coords),<br> (err) => console.error(err),<br> { maximumAge: 10000 }<br>);<br>// 后续需要停止时：<br>navigator.geolocation.clearWatch(watchId);注意：watchPosition() 不是“实时高频推送”，浏览器会按需节流（比如移动中才更新），且每次回调仍受 same-origin 和 HTTPS 限制。若页面切到后台，部分浏览器会暂停更新。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
移动端常见问题：iOS Safari 拒绝定位、Android WebView 白屏
iOS Safari 要求用户**手动开启“网站跟踪”或“位置服务”权限**，且首次调用必须由用户手势（如点击按钮）触发，不能在页面加载时自动执行；Android WebView 需显式启用定位权限并设置 WebSettings.setGeolocationEnabled(true)，否则 navigator.geolocation 直接为 undefined。另外，微信内置浏览器（X5 内核）对 geolocation 支持不稳定，建议降级 fallback 到 IP 地址粗略定位（如调用后端接口查 ipinfo.io）。
立即学习“Java免费学习笔记（深入）”；
