### 解决方案 在 Jupyter Notebook 中使用 `pyecharts` 渲染图表时，如果遇到无法显示的情况，通常是因为 JavaScript 文件未正确加载或环境配置存在问题。以下是几种常见的解决方法： #### 方法一：安装并启用 `pyecharts-jupyter-nbextension` 为了支持 Jupyter Notebook 的渲染功能，官方提供了专门的扩展工具 `pyecharts-jupyter-nbextension`。可以通过以下方式解决问题[^2]: 1. 安装插件： ```bash pip install pyecharts jupyter_contrib_nbextensions && jupyter contrib nbextension install --sys-prefix ``` 2. 启用插件： ```bash jupyter nbextension enable pyecharts/jupyter-js-charts ``` 完成上述步骤后，重启 Jupyter Notebook 并尝试重新运行代码。 --- #### 方法二：设置全局变量 `CurrentConfig.NOTEBOOK_TYPE` 通过显式声明当前使用的 Notebook 类型，可以确保 `pyecharts` 正确识别渲染环境[^3]。具体实现如下： ```python from pyecharts.globals import CurrentConfig, NotebookType # 设置 Notebook 类型为 JUPYTER_NOTEBOOK 或 JUPYTER_LAB CurrentConfig.NOTEBOOK_TYPE = NotebookType.JUPYTER_NOTEBOOK ``` 此方法适用于不同版本的 Jupyter Notebook 和 Jupyter Lab。 --- #### 方法三：指定 ECharts 静态资源路径 有时默认的在线资源可能由于网络原因不可访问，因此可以选择自定义静态资源路径[^5]。例如： ```python from pyecharts.globals import CurrentConfig # 自定义本地主机作为资源路径 CurrentConfig.ONLINE_HOST = "http://127.0.0.1:8000/assets/" # 如果需要使用 CDN 加载更快的资源 CurrentConfig.ONLINE_HOST = "https://cdn.jsdelivr.net/npm/echarts/dist/" ``` 需要注意的是，当使用本地服务器时，需提前启动服务以提供必要的 JS 文件。 --- #### 方法四：分步执行渲染逻辑 某些情况下，将加载 JavaScript 文件的操作与实际渲染分开可以帮助调试问题[^4]。例如： 1. 运行以下代码加载基础 JavaScript 文件： ```python from pyecharts.charts import Bar from pyecharts import options as opts # 创建一个简单的柱状图实例 bar = ( Bar() .add_xaxis(["A", "B", "C"]) .add_yaxis("Series 1", [1, 2, 3]) ) # 输出 HTML 片段用于加载 echarts.js bar.render_embed() ``` 2. 在另一个单元格中调用 `render_notebook()` 方法： ```python bar.render_notebook() ``` 这种方法有助于排查是否是 JavaScript 文件加载失败导致的问题。 --- #### 方法五：升级至最新版 PyEcharts 部分旧版本可能存在兼容性问题，建议升级到最新的稳定版本[^2]。命令如下： ```bash pip install --upgrade pyecharts ``` 同时确认所使用的 Python 环境与其他依赖项无冲突。 --- ### 注意事项 - 若仍然无法正常工作，请检查浏览器控制台是否有错误提示，特别是关于资源加载失败的信息。 - 对于离线环境，推荐下载所需的 JS 文件并通过 `ONLINE_HOST` 参数指向本地存储位置。 ---