Pyecharts HTML打不开是因浏览器禁用file://协议加载资源，应启用HTTP服务预览或用render_notebook()；链式调用须以render()结尾；中文乱码需在set_global_opts中设置font_family；生产环境宜用CDN模式避免内联资源问题。
Pyecharts 生成的 HTML 打不开？先检查 render() 输出路径和浏览器打开方式
Pyecharts 默认调用 render() 会生成一个本地 HTML 文件，但很多人双击直接用系统默认浏览器（比如 Edge 或 Safari）打开时，图表空白——这是因为现代浏览器出于安全限制，禁止从 file:// 协议加载某些资源（如 ECharts 的 JS 模块）。不是代码错了，是打开方式不对。
- 正确做法：用 Python 启一个最小 HTTP 服务预览，例如在生成 HTML 后执行
python -m http.server 8000，然后访问http://localhost:8000/your_chart.html - 或者改用
render_notebook()在 Jupyter 中直接渲染（仅限 notebook 环境） - 避免把 HTML 放进带空格或中文路径的文件夹里，部分旧版 Pyecharts 对路径编码处理不稳
为什么 Bar().add_xaxis().add_yaxis() 不显示数据？注意链式调用必须以 render() 结尾
Pyecharts 是链式 API，所有绘图方法（如 add_xaxis()、add_yaxis()、set_global_opts()）都返回自身实例，但它们只是“配置”，不会自动触发渲染。漏掉最后一步，就等于只写了 SQL 没执行 execute()。
- 常见错误写法：
bar = Bar().add_xaxis([...]).add_yaxis(...)—— 这段代码什么都不会输出 - 必须显式调用：
bar.render("output.html")或bar.render_notebook() - 如果想复用配置，记得每次重新实例化：
bar2 = Bar().add_xaxis(...).set_global_opts(...).render("b.html")，不要试图复用已 render 过的对象
图表样式乱了 / 中文显示为方块？init_opts 和 set_global_opts 的字体设置别混用
Pyecharts 渲染依赖前端 ECharts，而 ECharts 默认不带中文字体。Python 层的字体设置分两层：初始化全局样式（影响 canvas 渲染）和图表级配置（影响标题、坐标轴等文本）。设错位置，中文照样变豆腐块。
-
init_opts里用opts.InitOpts(width="800px", height="400px", chart_id="mybar")只控制尺寸和 ID，不处理字体 - 中文字体必须在
set_global_opts()里配：title_opts=opts.TitleOpts(title="销售额", subtitle="2024", title_textstyle_opts=opts.TextStyleOpts(font_family="sans-serif")) - 更稳妥的做法：在 HTML 模板里手动注入
@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC');，然后统一设font_family="Noto Sans SC"
部署到服务器后图表空白？别直接传 render() 生成的单 HTML
render() 默认生成的是「内联资源」HTML（JS/CSS 都 base64 编码塞进 script 标签），体积大、调试难，且某些 CDN 或 Nginx 配置会拦截 data: 协议导致加载失败。生产环境推荐分离资源。
立即学习“Python免费学习笔记（深入）”；
- 改用
render_embed()获取纯 HTML 片段，自己拼进模板（Django/Flask） - 或启用在线 CDN 模式：
Bar(init_opts=opts.InitOpts(chart_id="mychart", renderer="canvas", theme="light", bg_color="#fff", width="800px", height="400px", js_host="https://cdn.jsdelivr.net/npm/echarts@5.4.3/dist/")) - 注意 CDN 版本要和本地 Pyecharts 兼容（Pyecharts 2.0+ 对应 ECharts 5.x；1.x 对应 4.x），版本错配会导致
echarts is not defined
真正麻烦的不是写几行代码，而是搞清哪段逻辑跑在 Python，哪段实际由浏览器执行——中间隔着 HTML、JS、网络、字体、CSP 等好几层。一个 render() 调用背后，其实是在调度两个运行时环境。
