十分钟做出第一张地图

完整起步代码

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/leaflet@1.9.4/dist/leaflet.css">
  <style>
    html, body { height: 100%; margin: 0; }
    #map { height: 100%; }
  </style>
</head>
<body>
  <div id="map"></div>
  <script src="https://cdn.jsdelivr.net/npm/leaflet@1.9.4/dist/leaflet.js"></script>
  <script>
    var map = L.map('map', {
      center: [39.907359, 116.391263],
      zoom: 11
    });

    L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
      maxZoom: 19,
      attribution: '&copy; OpenStreetMap contributors'
    }).addTo(map);
  </script>
</body>
</html>

三个必须理解的点

一、容器必须有确定高度

地图空白、控制台没有任何报错，九成是容器高度为零。 #map { height: 100% } 只有在父元素也有确定高度时才成立。 常见的稳妥写法是让 html、body 和地图容器都设 height: 100%， 或者用 flex 布局让地图自动吃掉剩余空间。

二、坐标顺序是「纬度在前」

center: [39.9, 116.4] 是北京，写成 [116.4, 39.9] 就到南极去了。 Leaflet 全线使用 [lat, lng]，而 GeoJSON 规范是 [lng, lat]， 这两个顺序相反，是新手最常见的错位来源。

三、瓦片地址里的三个占位符

{z}/{x}/{y} 分别对应缩放级别、列号、行号。 换底图本质上只改这一行 URL。天地图、高德、腾讯都提供类似的瓦片地址， 区别在于需要各自的 Key，以及高德腾讯使用 GCJ-02 坐标系。

坐标偏移问题

如果用高德或天地图的瓦片，再把 GPS 采集的坐标直接标上去，会看到所有点整体偏了 几百米。这不是 Leaflet 的问题，是 GCJ-02 加密坐标与 WGS84 的差异。 处理方式见坐标系汇总里的实测数据。

常见问题

地图出来了但瓦片是灰的

瓦片请求失败。国内访问 OpenStreetMap 有时较慢，可以换成国内瓦片服务， 或者监听图层的 tileerror 事件把失败情况显式提示出来， 而不是让用户对着灰块猜。

缩放时地图抖动

检查有没有给容器设置 transition 或 CSS 动画， Leaflet 自己在缩放时会做变换，外层再叠加动画就会冲突。