可行但需防护：Geolocation API 必须在 HTTPS 或 localhost 安全上下文中运行，file:// 无效；须先检查 navigator.geolocation 和 permissions.query 状态，再调用 getCurrentPosition，并校验 coords.accuracy。
直接在 index.html 里调用 navigator.geolocation.getCurrentPosition() 是可行的，但**不加防护就执行，90% 的情况会静默失败或报错**——不是代码写错了，而是浏览器根本没给你机会运行。
为什么刚打开 index.html 就调用会失败
现代浏览器（Chrome、Edge、Firefox）强制要求 Geolocation API 必须运行在「安全上下文」中。HTTP 协议下，navigator.geolocation 本身就是 undefined；即使你在本地双击打开 file:// 路径，大多数新版浏览器也会拒绝激活该 API。
- HTTPS 是硬门槛：生产环境必须部署在 HTTPS 域名下（如
https://your-site.com/index.html） - 开发阶段可接受：
localhost或127.0.0.1（哪怕 HTTP）通常被允许，但file://不行 - 检查是否可用不能只靠
"geolocation" in navigator：在非安全上下文中，这句返回true，但后续调用仍会立刻进 error 回调，error.code === 1（PERMISSION_DENIED）
必须写的三段基础防护代码
把下面这段逻辑塞进你的 index.html 的 <script> 里，别跳过任何一行：
if (!navigator.geolocation) {
console.error('浏览器不支持 geolocation');
return;
}
// 先查权限状态，避免盲目触发弹窗
navigator.permissions.query({ name: 'geolocation' }).then(result => {
if (result.state === 'denied') {
console.warn('地理位置权限已被用户手动禁用');
// 此时 getCurrentPosition() 会立刻失败，建议引导用户去浏览器设置开启
return;
}
// 用户还没授予权限（prompt）或已授权（granted），才真正发起请求
navigator.geolocation.getCurrentPosition(
pos => console.log(pos.coords.latitude, pos.coords.longitude),
err => console.error('定位失败:', err.code, err.message),
{ timeout: 8000, enableHighAccuracy: false }
);
});
-
navigator.permissions.query是关键：它能提前知道用户是否已“永久拒绝”，避免白弹一次权限框又失败 -
enableHighAccuracy: false是默认值，设为true可能卡住几秒甚至十几秒（尤其在无 GPS 的 PC 上），且耗电——外卖/天气类应用通常不需要米级精度 -
timeout必须显式设，否则某些 Android WebView 会卡死在 30 秒以上
常见错误信息与对应动作
你看到的 error.code 值，直接决定下一步该做什么：
立即学习“前端免费学习笔记（深入）”；
-
error.code === 1（PERMISSION_DENIED）：用户点了“拒绝”或之前在设置里关了。**不要重试**，改用地址输入框 + 地理编码（geocoding）作为 fallback -
error.code === 2（POSITION_UNAVAILABLE）：设备没开定位、在电梯/地下室、或 Wi-Fi/GPS 信号极差。提示“请检查设备定位开关并靠近窗户”比刷屏报错更有效 -
error.code === 3（TIMEOUT）：说明timeout设置太短，或网络延迟高。可降级为用 IP 定位库（如ipapi.co）粗略估算城市级位置
别忽略 coords.accuracy 这个数值
拿到 position.coords 后，第一眼要看的不是经纬度，而是 position.coords.accuracy（单位：米）。这个数告诉你定位结果有多可信：
-
accuracy < 50：大概率是 GPS，适合导航、打车类场景 -
50 < accuracy < 1000：Wi-Fi 或基站定位，适合“附近餐厅”推荐 -
accuracy > 1000：基本是 IP 定位，误差可能达几公里，别拿来画地图标记点
真实项目里，很多“定位不准”的投诉，其实是因为前端没校验 accuracy 就直接渲染，把用户显示在隔壁城市。
