为什么 pyecharts 在 Jupyter Notebook 里显示空白？

📊 为什么 pyecharts 在 Jupyter Notebook 里显示空白？90% 的人都踩过这个坑！

“HTML 能打开，Jupyter 却一片空白？”
别急，不是你的代码错了，而是你漏了关键两行！

最近有不少朋友私信我：

“我用pyecharts画了个柱状图，保存成 HTML 能正常打开，但在 Jupyter Notebook 里却什么也看不到，一片空白！”

这个问题其实非常常见——尤其是在PyCharm、VS Code 或企业内网环境中使用pyecharts时。

今天就手把手教你彻底解决 Jupyter 中 pyecharts 图表不显示的问题，附完整可运行代码 ✅

❌ 问题复现：看似没问题，实则“隐形错误”

很多人的初始代码长这样：

frompyecharts.chartsimportBarfrompyechartsimportoptionsasopts bar=(Bar().add_xaxis(["衬衫","毛衣","领带"]).add_yaxis("销量",["114","55","27"])# ⚠️ 字符串！.set_global_opts(title_opts=opts.TitleOpts(title="销售统计")))bar.render_notebook()

结果：Jupyter 里一片空白，但bar.render("test.html")打开却完全正常！

🔍 根本原因有三个

1. Y 轴用了字符串"114"而非数字114→ 部分版本无法解析
2. 未指定运行环境类型→pyecharts不知道你在用 JupyterLab 还是普通网页
3. JavaScript 资源未加载→ 尤其在无外网或 PyCharm 环境中，CDN 被阻断

✅ 终极解决方案（亲测有效）

只需加两行配置 + 调一个方法，图表立刻显示！

# === 关键初始化：告诉 pyecharts 你在用 JupyterLab ===frompyecharts.globalsimportCurrentConfig,NotebookType CurrentConfig.NOTEBOOK_TYPE=NotebookType.JUPYTER_LABfrompyecharts.chartsimportBar# 数据必须是数字！x=['衬衫','毛衣','领带','裤子']y1=[114,55,27,101]y2=[80,60,40,90]bar=Bar()bar.add_xaxis(x)bar.add_yaxis("商家A",y1)bar.add_yaxis("商家B",y2)# === 关键一步：强制加载 JS 资源 ===bar.load_javascript()# 渲染到 Notebookbar.render_notebook()

✅ 运行后，图表立刻出现在单元格下方！在这里插入图片描述

💡 原理解释

• CurrentConfig.NOTEBOOK_TYPE = NotebookType.JUPYTER_LAB
  → 让pyecharts按 JupyterLab 的方式注入 HTML/JS，避免渲染错位。

• bar.load_javascript()
  → 显式加载 ECharts 的 JavaScript 库。即使没有网络，也会从本地缓存加载（首次运行会自动下载）。

📌 小贴士：如果你用的是标准 Jupyter Notebook（非 Lab），可改为：

CurrentConfig.NOTEBOOK_TYPE=NotebookType.JUPYTER_NOTEBOOK

🛠️ 额外建议

• 始终用数字列表，不要用字符串表示数值
• 如果公司网络限制外网，建议加上：

  frompyecharts.globalsimportCurrentConfig CurrentConfig.ONLINE_HOST=""# 强制使用本地资源

• 可将初始化代码封装成模板，每次新建 notebook 直接复制

🎁 结语

pyecharts是一个强大又美观的可视化库，但在 Jupyter 中“显示空白”确实劝退了不少初学者。

其实，不是工具不行，只是缺了那两行“魔法代码”。

希望这篇推文能帮你少走弯路，快速画出漂亮的交互式图表！