Jupyter Notebook中Plotly Offline无法运行求助

这个问题我之前帮好几个开发者排查过，算是Plotly和Jupyter配合时的常见坑，别着急，咱们一步步来解决：

先确认你用的是经典Jupyter Notebook还是JupyterLab #

这俩的解决方案不太一样，先分清楚：

如果你用的是经典Jupyter Notebook（打开后是localhost:8888/tree界面的版本） #

• 第一步：更新依赖包
  这个错误很多时候是因为Plotly、ipywidgets版本不兼容或者缺失导致的，先执行下面的命令更新（用pip或者conda看你平时的环境）：

  # pip用户
  pip install --upgrade plotly ipywidgets
  # conda用户
  conda install -c plotly plotly ipywidgets --force-reinstall
  

• 第二步：修正初始化代码并重启内核
  把你的初始化代码改成更完整的写法，然后重启Notebook内核（点击界面上的「Kernel」→「Restart」），再重新运行：

  import plotly.offline as pyo
  # 初始化notebook模式
  pyo.init_notebook_mode(connected=True)
  # 测试一下，比如画个简单的图验证
  import plotly.graph_objects as go
  fig = go.Figure(data=[go.Bar(y=[2, 3, 1])])
  pyo.iplot(fig)
  

• 第三步：检查浏览器设置
  如果你用的是浏览器的隐私/无痕模式，可能会阻止requirejs这类脚本加载，换成普通模式打开Notebook试试；另外确保浏览器没有禁用JavaScript。

如果你用的是JupyterLab #

JupyterLab对扩展的要求更严格，需要安装对应的Plotly扩展：

• 先安装扩展包：

  # 安装Plotly的JupyterLab扩展
  jupyter labextension install jupyterlab-plotly
  # 安装widgets依赖（Plotly交互功能需要）
  jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget
  

• 安装完成后，完全关闭JupyterLab（包括浏览器标签和后台进程），再重新启动，然后运行你的初始化代码。

其他可能的排查方向 #

• 如果你在虚拟环境中运行Jupyter，要确保虚拟环境的内核已经正确安装：

  ipython kernel install --user --name=你的虚拟环境名称
  

  然后在Notebook中切换到对应的内核再运行代码。
• 如果你用的是非常旧的Plotly版本（比如3.x及以下），建议直接升级到最新稳定版，旧版本的Offline模式在新Jupyter环境中容易出现兼容性问题。

内容的提问来源于stack exchange，提问作者facha