pyecharts不支持开箱即用的动态时间序列地图，timeline+map易因geo配置不一致导致偏移、标签丢失等问题；应复用单个map实例，手动更新series数据并显式注册中国省级geojson。
Pyecharts 本身不直接支持动态时间序列地图（比如按年份切换的中国省份数据动画），它内置的 Map 组件是静态地理编码渲染，所谓“动态”通常得靠手动轮播、事件绑定或结合 Timeline 实现——但要注意：Timeline + Map 在 v2.0+ 版本中存在坐标系错位、标签丢失等常见问题，不是开箱即用的“播放键”。
为什么直接用 Timeline 套 Map 容易失败？
Pyecharts 的 Timeline 默认为每个子图创建独立的 init_opts 和 toolbox_opts，而 Map 严重依赖全局 geo 配置（如 maptype、roam、layoutCenter）。一旦各帧 Map 实例的 geo 初始化不一致，就会出现：
• 省界突然缩放偏移
• 某些年份数据点全部挤在左上角
• tooltip 不显示或显示为空
• 切换时地图重绘卡顿甚至白屏
真正可行的“动态地图”做法：用 Map + set_global_opts 手动控制图例与时间轴
绕过 Timeline，改用单个 Map 实例 + 自定义 HTML 控件（如下拉菜单或按钮）触发数据更新。关键在于：
• 复用同一 geo 实例，避免重复初始化
• 用 add 方法反复覆盖 series 数据（而非新建图表）
• 时间信息通过 legend_opts 或页面标题动态更新
- 必须调用
map_instance.set_series_opts(label_opts=opts.LabelOpts(is_show=True))，否则切换后文字标签会消失 - 数据格式必须始终为
[("北京", 123), ("上海", 456)]这种二元列表，不能混用字典或带额外字段的对象 - 若用 Flask 渲染，不要在循环里反复调用
render()，应只 render 一次，用 JS 绑定chart.setOption()更新
中国地图数据缺失或乱码？检查 maptype 和 register_map
Pyecharts 默认不内置中国省级 GeoJSON，maptype="china" 仅支持国家轮廓；要画省/市地图，必须显式注册：
from pyecharts import options as opts
from pyecharts.charts import Map
from pyecharts.datasets import register_map
<h1>下载 geojson 文件（推荐使用官方维护的 pyecharts-assets）</h1><h1>或从 <a href="https://www.php.cn/link/fcdae5acb17cd164a212d497d591b2ba">https://www.php.cn/link/fcdae5acb17cd164a212d497d591b2ba</a> 获取 china-cities.json</h1><p>register_map("china-cities", "path/to/china-cities.json")</p><p>map_chart = Map()
map_chart.add("人口", data_pair=[("北京市", 2154), ("广东省", 12601)], maptype="china-cities")
</p>
常见坑：
• 路径写相对路径但没配好工作目录 → 报错 FileNotFoundError: [Errno 2] No such file
• JSON 中的 name 字段含空格或括号（如“内蒙古自治区”），而你的数据用的是“内蒙古” → 匹配失败，该区域无颜色
• 使用了非 UTF-8 编码保存的 JSON → 中文全变
动态地图真正的复杂点不在代码行数，而在于地理数据对齐和状态同步——比如用户缩放过地图再切换年份，要不要重置视图？tooltip 显示的是原始数值还是同比变化？这些逻辑不会被 Timeline 自动处理，得自己用 JS 或 Python 后端补全。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
