folium.Map需指定location=[lat,lon]和zoom_start=12–14，推荐tiles="CartoDB positron"；标记须确保经纬度为float且调用.add_to()；GeoJSON需过滤null几何体并确保WGS84坐标系；HTML须通过本地服务器而非双击打开。
怎么用 folium.Map 初始化一个能点开看的底图
关键不是“画出来”，而是让地图加载成功且可交互。默认初始化不指定 location 或 zoom_start，生成的 HTML 打开后可能空白或卡在海洋中央。
实操建议：
立即学习“Python免费学习笔记（深入）”；
-
location必须是[lat, lon]形式（不是字符串），比如北京中心：[39.9042, 116.4074] -
zoom_start别设太高（如 18），移动端容易卡；城市级展示用12–14更稳妥 - 国内用户记得换底图源，否则默认
OpenStreetMap在部分地区加载慢甚至失败，加tiles="CartoDB positron"或tiles="https://tile.openstreetmap.org/{z}/{x}/{y}.png"更可靠
往地图上加标记为什么点不动、不显示或者全叠在一起
常见错误是直接传入 pandas DataFrame 的 lat 和 lon 列但没做类型校验，或循环里反复调用 folium.Marker 却忘了 .add_to(map_obj)。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确保经纬度是 float 类型，
df['lat'].dtype是float64，不是object（常见于空值转成字符串） - 每建一个
folium.Marker，必须显式调用.add_to(m)，不能只写folium.Marker(...)就完事 - 如果所有标记都落在同一个点，大概率是读取 CSV 时列名写错，比如把
"lng"写成"long"导致该列全为 NaN，folium 默认填 0 - 想加弹窗文字？用
popup=folium.Popup("内容", parse_html=True)，纯字符串会自动转义，中文可能乱码
folium.GeoJson 加载行政区划边界总报错 ValueError: Unhandled type: <class></class>
这基本等于 GeoJSON 数据里有 null 几何体（比如某条记录的 "geometry" 字段是 null），folium.GeoJson 默认不跳过，直接崩。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 先用 Python 预处理数据：用
geopandas.read_file()读，再gdf = gdf.dropna(subset=['geometry'])，然后导出干净 JSON：gdf.to_json() - 如果只能硬啃原始 JSON，加参数
style_function=lambda x: {'fillColor': '#blue'} if x['geometry'] else {}，但更推荐源头过滤 - 注意坐标系：folium 只认 WGS84（EPSG:4326），如果你的 GeoJSON 是 GCJ-02（高德/腾讯偏移）或 BD-09（百度），标记位置会整体偏移几十公里，必须先纠偏再喂给 folium
保存和打开交互地图后为啥缩放/点击失效，或者提示 “This page is accessing resources from unauthenticated sources”
本质是浏览器安全策略拦截了本地文件协议（file://）下的 JS 资源加载。folium 生成的 HTML 依赖 CDN 上的 Leaflet.js，而现代浏览器对本地打开的 HTML 默认禁用跨域请求。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 别双击直接打开 HTML，用 Python 启一个最小服务器：
python -m http.server 8000，然后访问http://localhost:8000/your_map.html - 或者用
map_obj.save("map.html")后，通过 VS Code 插件 “Live Server” 点击右下角 “Go Live” - 如果必须发给他人离线使用，改用
folium.Map(..., tiles=None)+ 手动把 Leaflet.js 下载下来，用plugins.JsMarkerCluster等插件前也得同步本地化 JS/CSS，工作量陡增——不如接受“得跑个轻量服务”这个事实
真正麻烦的从来不是画点，是让每个标记在不同设备、不同网络、不同坐标系下都稳稳落在该落的地方。稍一松懈，偏移、空白、报错就全来了。
