核心内容摘要
17.c1起草的看
为什么 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_optsopts.TitleOpts(title销售统计)))bar.render_notebook()结果Jupyter 里一片空白但bar.render(test.html)打开却完全正常 根本原因有三个Y 轴用了字符串114而非数字114→ 部分版本无法解析未指定运行环境类型→pyecharts不知道你在用 JupyterLab 还是普通网页JavaScript 资源未加载→ 尤其在无外网或 PyCharm 环境中CDN 被阻断✅ 终极解决方案亲测有效只需加两行配置 调一个方法图表立刻显示# 关键初始化告诉 pyecharts 你在用 JupyterLab frompyecharts.globalsimportCurrentConfig,NotebookType CurrentConfig.NOTEBOOK_TYPENotebookType.JUPYTER_LABfrompyecharts.chartsimportBar# 数据必须是数字x[衬衫,毛衣,领带,裤子]y1[114,55,27,101]y2[80,60,40,90]barBar()bar.add_xaxis(x)bar.add_yaxis(商家A,y
bar.add_yaxis(商家B,y
# 关键一步强制加载 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_TYPENotebookType.JUPYTER_NOTEBOOK️ 额外建议始终用数字列表不要用字符串表示数值如果公司网络限制外网建议加上frompyecharts.globalsimportCurrentConfig CurrentConfig.ONLINE_HOST# 强制使用本地资源可将初始化代码封装成模板每次新建 notebook 直接复制 结语pyecharts是一个强大又美观的可视化库但在 Jupyter 中“显示空白”确实劝退了不少初学者。
其实不是工具不行只是缺了那两行“魔法代码”。
希望这篇推文能帮你少走弯路快速画出漂亮的交互式图表