Pyecharts 2.x在Flask中需用render_embed()生成HTML片段并配合|safe过滤器渲染，动态更新应由Flask提供JSON接口、前端调用setOption()；Page/Grid无render_embed()方法，须拆图或改用dump_options_with_quotes()；Nginx部署需确保ECharts JS正确加载。
Pyecharts 2.x 渲染图表到 Flask 模板时空白或报错 TemplateNotFound
Pyecharts 2.x 默认不生成 HTML 文件，而是返回 Chart 对象，直接丢进 Jinja 模板会出错——模板里不能直接渲染 Python 对象。常见现象是页面空白，控制台无报错，但浏览器源码里看不到任何 <div id="chart"> 或 ECharts 初始化脚本。
正确做法是用 render_embed() 把图表转成带容器和初始化代码的 HTML 片段（字符串），再传给模板。注意不是 render()（它会写文件）也不是 dump_options_with_quotes()（那是给前端 JS 直接调用的 JSON，需额外写 JS 初始化逻辑）。
-
render_embed()返回完整 HTML 字符串，含<div>+<script>，可直接插入 Jinja 的{{ chart_html|safe }} - Flask 路由中必须用
render_template("index.html", chart_html=bar.render_embed()) - Jinja 模板里必须加
|safe过滤器，否则 HTML 会被转义显示为纯文本 - 确保已加载 ECharts 官方 JS：在模板
<head>或底部加<script src="https://cdn.jsdelivr.net/npm/echarts@5.4.3/dist/echarts.min.js"></script>
动态更新图表数据时后端如何响应前端 AJAX 请求
大屏需要定时刷新数据，不能整页 reload。Pyecharts 本身不提供 API 接口能力，得靠 Flask 写一个返回 JSON 的路由，前端用 fetch 或 axios 调用，拿到新数据后用原生 ECharts 实例的 setOption() 更新。
关键点在于：后端不返回图表 HTML，只返回干净的数据结构（如 {"xAxis": [...], "series": [...]}），前端复用已有 ECharts 实例做局部更新，性能更好、无闪烁。
立即学习“Python免费学习笔记（深入）”；
- Flask 路由返回
jsonify({"xAxis": ["周一", "周二"], "series": [{"name": "销量", "data": [120, 200]}]}) - 前端初始化图表时保存实例：
const myChart = echarts.init(document.getElementById("chart")); - AJAX 成功后调用
myChart.setOption(newData)，不是重新 init - 避免在每次请求后调用
myChart.dispose()或重建 DOM 容器，这会导致重绘卡顿
使用 Page 或 Grid 多图布局时，render_embed() 不生效
Page 和 Grid 是 Pyecharts 的复合图表类，它们没有 render_embed() 方法，直接调用会报 AttributeError。这是 2.x 版本常见的误用点。
解决路径只有两条：要么拆成单个图表分别嵌入，要么放弃 render_embed()，改用 dump_options_with_quotes() + 前端手动初始化。
- 若坚持服务端渲染：用
Tab或多个独立Bar/Line，各自调render_embed()，在 Jinja 中用<div class="chart-item">{{ bar1_html|safe }}</div>分开包裹 - 若需 Grid 对齐或联动：必须前端初始化，后端提供统一接口返回所有子图的
dump_options_with_quotes()结果（即 JSON 字符串），前端用JSON.parse()后分别setOption() -
dump_options_with_quotes()输出的 JSON 已处理双引号转义，适合直接塞进 JS 字符串，但注意它不含 DOM 容器定义，需提前写好对应<div id="chart1"></div>
部署到 Nginx + Gunicorn 后图表加载失败或样式错乱
本地 Flask 开发服务器能跑通，但上线后图表区域空白、字体模糊、动画卡顿，大概率是静态资源路径或 MIME 类型问题。Pyecharts 生成的 HTML 片段依赖 ECharts JS 和可选的字体/CSS，而这些不会自动被 Flask 静态目录托管。
根本原因不是 Pyecharts，而是前端资源没正确加载。Nginx 默认不代理 /static/ 下的 JS 文件，或未配置 application/javascript MIME 类型，导致浏览器拒绝执行。
- 禁止在 Flask 中用
url_for("static", filename="echarts.min.js")引入——Pyecharts 的render_embed()不识别这个，它硬编码的是 CDN 地址 - 检查浏览器开发者工具 Network 标签：确认
echarts.min.js状态码是 200，不是 404 或 MIME 错误 - Nginx 配置中添加：
location ~ \.js$ { add_header Content-Type application/javascript; } - 若用内网或离线环境，把 ECharts JS 下载到
static/js/，并在模板中显式引用<script src="{{ url_for('static', filename='js/echarts.min.js') }}"></script>
