常见问题与迁移
| 问题 | 检查方式 |
|---|---|
| SukhaSDK 未定义 | SDK 普通 script 是否先加载；是否误用 async |
| 白屏 | 容器高度、map.ready 失败、授权、数据集、WebGL |
| 地图在 Tab 中不显示 | 显示后调用 map.resize() |
| 本地双击 HTML 不工作 | 使用 HTTP(S)/localhost，不用 file:// |
| 点偏移 | 经度/纬度顺序、WGS84/GCJ02、是否重复转换 |
| 联想结果“少一次” | 同实例新请求会取消旧请求 |
| 路线约束不支持 | 核对后端版本与能力，不能忽略错误 |
| 语音不响 | 用户手势 unlockVoice、资源 URL/MIME、浏览器解码 |
| 浏览器后台定位停止 | 平台限制；长时间导航使用原生方案 |
| 高德示例参数报错 | 仅使用本文和类型声明支持的参数 |
迁移时需要更换 Key、数据集、POI ID、坐标约定与策略值。Loader 的 plugin 用于名称校验，功能已在当前包中；它不是高德按需插件下载机制。信息窗字符串是纯文本。可选 @sukha/maps/amap-compat 仅适配部分调用形态，不等于完整高德接口兼容；新项目建议直接使用本文入口。