先让地图显示出来
学习地图 API 时，我觉得第一步不是急着做复杂功能，而是确认地图能稳定显示。页面需要准备一个有明确宽高的容器，脚本加载完成后再创建地图实例，并设置中心点和缩放级别。
如果地图区域是一片空白，常见原因可能是容器高度为零、脚本没有正确加载、密钥配置有误，或者初始化代码执行得太早。
标注与信息窗口
地图显示出来以后，可以逐步加入标注。标注通常由坐标点创建，再添加到地图实例上。信息窗口则适合展示地点名称、说明文字或简单状态。
- 先用固定坐标测试标注，确认基础流程。
- 再把坐标数据抽成数组，循环生成多个标注。
- 最后再考虑点击事件、弹窗内容和样式细节。
坐标体系需要认真确认
地图开发里很容易被坐标体系绊住。不同来源的数据可能使用不同坐标标准，如果没有转换，标注位置就可能出现偏移。学习阶段可以先使用官方示例里的坐标，确认 API 调用没问题，再接入自己的数据。
这类问题提醒我：地图不是普通页面组件，它背后涉及真实空间数据。坐标是否正确，比视觉样式更基础。
一点小结
百度地图 API 的学习适合小步推进。先初始化，再加标注，再加事件，最后再组织数据。每一步都确认结果，比一次性写很多功能更稳。