### 问题分析 在 Jupyter Notebook 中使用 Pyecharts 的 `render_notebook()` 方法时，如果图像无法正常显示，通常是由以下原因导致的：静态资源文件未正确加载、插件未激活或环境配置不当。以下是具体的解决方案。 --- ### 解决方案 #### 1. 安装并配置 `pyecharts-assets` 确保安装了 `pyecharts-assets` 并正确配置了 Jupyter Notebook 插件。具体步骤如下： - 克隆 `pyecharts-assets` 仓库到本地： ```bash git clone https://github.com/pyecharts/pyecharts-assets.git ``` - 进入克隆文件夹并安装插件： ```bash cd pyecharts-assets jupyter nbextension install assets ``` - 激活插件： ```bash jupyter nbextension enable assets/main ``` 上述操作可以确保静态资源文件（如 JavaScript 文件）能够被正确加载[^1]。 #### 2. 检查网络连接 Pyecharts 默认从远程地址 `https://assets.pyecharts.org/assets/` 加载静态资源文件。如果网络不稳定或无法访问该地址，可能会导致图表无法显示。为解决此问题，可以将静态资源文件托管到本地环境[^2]。 #### 3. 确保正确的 Notebook 类型声明 如果使用的是 Jupyter Lab，需要在代码中显式声明 Notebook 类型。例如，在引入 `pyecharts.charts` 模块前添加以下代码： ```python from pyecharts.globals import CurrentConfig, NotebookType CurrentConfig.NOTEBOOK_TYPE = NotebookType.JUPYTER_LAB ``` 这一步对于 Jupyter Lab 环境尤为重要[^4]。 #### 4. 调用 `load_javascript()` 方法 在首次渲染图表之前，调用 `load_javascript()` 方法以加载必要的 JavaScript 文件。例如： ```python from pyecharts.charts import Bar from pyecharts import options as opts bar = Bar() bar.add_xaxis(["A", "B", "C"]) bar.add_yaxis("示例数据", [10, 20, 30]) # 加载 JavaScript 文件 bar.load_javascript() # 渲染图表 bar.render_notebook() ``` 注意：`load_javascript()` 和 `render_notebook()` 方法应分别位于不同的单元格中，以确保 Notebook 的内联机制正常工作。 #### 5. 检查 Python 和 Pyecharts 版本兼容性 确保使用的 Python 和 Pyecharts 版本兼容。例如，Pyecharts 1.9.1 可能需要特定版本的依赖库。如果怀疑版本不匹配，可以尝试重新安装 Pyecharts： ```bash pip uninstall pyecharts pip install pyecharts==1.9.1 ``` 同时，重启 Jupyter Notebook 内核以应用更新后的包[^3]。 --- ### 示例代码 以下是一个完整的示例代码，展示如何在 Jupyter Notebook 中使用 Pyecharts 绘制图表： ```python # 声明 Notebook 类型（如果使用 Jupyter Lab） from pyecharts.globals import CurrentConfig, NotebookType CurrentConfig.NOTEBOOK_TYPE = NotebookType.JUPYTER_LAB # 导入必要模块 from pyecharts.charts import Bar from pyecharts import options as opts # 创建图表实例 bar = Bar() bar.add_xaxis(["类别A", "类别B", "类别C"]) bar.add_yaxis("示例数据", [10, 20, 30]) # 加载 JavaScript 文件 bar.load_javascript() # 渲染图表 bar.render_notebook() ``` --- ### 注意事项 - 如果问题仍未解决，可以尝试清理浏览器缓存或更换浏览器。 - 确保 Jupyter Notebook 的版本与 Pyecharts 兼容。 - 如果使用的是离线环境，建议将静态资源文件托管到本地服务器。 ---