📊 为什么 pyecharts 在 Jupyter Notebook 里显示空白？90% 的人都踩过这个坑！
"HTML 能打开，Jupyter 却一片空白？"
别急，不是你的代码错了，而是你漏了关键两行！
最近有不少朋友私信我：
"我用
pyecharts画了个柱状图，保存成 HTML 能正常打开，但在 Jupyter Notebook 里却什么也看不到，一片空白！"
这个问题其实非常常见------尤其是在 PyCharm、VS Code 或企业内网环境 中使用 pyecharts 时。
今天就手把手教你 彻底解决 Jupyter 中 pyecharts 图表不显示的问题，附完整可运行代码 ✅
❌ 问题复现：看似没问题，实则"隐形错误"
很多人的初始代码长这样：
python
from pyecharts.charts import Bar
from pyecharts import options as opts
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") 打开却完全正常！
🔍 根本原因有三个
- Y 轴用了字符串
"114"而非数字114→ 部分版本无法解析 - 未指定运行环境类型 →
pyecharts不知道你在用 JupyterLab 还是普通网页 - JavaScript 资源未加载 → 尤其在无外网或 PyCharm 环境中，CDN 被阻断
✅ 终极解决方案（亲测有效）
只需 加两行配置 + 调一个方法，图表立刻显示！
python
# === 关键初始化：告诉 pyecharts 你在用 JupyterLab ===
from pyecharts.globals import CurrentConfig, NotebookType
CurrentConfig.NOTEBOOK_TYPE = NotebookType.JUPYTER_LAB
from pyecharts.charts import Bar
# 数据必须是数字！
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()
# 渲染到 Notebook
bar.render_notebook()✅ 运行后，图表立刻出现在单元格下方！在这里插入图片描述
💡 原理解释
-
CurrentConfig.NOTEBOOK_TYPE = NotebookType.JUPYTER_LAB→ 让
pyecharts按 JupyterLab 的方式注入 HTML/JS，避免渲染错位。 -
bar.load_javascript()→ 显式加载 ECharts 的 JavaScript 库。即使没有网络，也会从本地缓存加载（首次运行会自动下载）。
📌 小贴士：如果你用的是 标准 Jupyter Notebook（非 Lab），可改为：
pythonCurrentConfig.NOTEBOOK_TYPE = NotebookType.JUPYTER_NOTEBOOK
🛠️ 额外建议
-
始终用数字列表，不要用字符串表示数值
-
如果公司网络限制外网，建议加上：
pythonfrom pyecharts.globals import CurrentConfig CurrentConfig.ONLINE_HOST = "" # 强制使用本地资源 -
可将初始化代码封装成模板，每次新建 notebook 直接复制
🎁 结语
pyecharts 是一个强大又美观的可视化库，但在 Jupyter 中"显示空白"确实劝退了不少初学者。
其实，不是工具不行，只是缺了那两行"魔法代码"。
希望这篇推文能帮你少走弯路，快速画出漂亮的交互式图表！