Plotly.py 6.0.0版本在Jupyter Notebook中的性能问题分析

Plotly是一个流行的Python数据可视化库，最新发布的6.0.0版本在Jupyter Notebook环境中出现了一个严重的性能问题——生成的Notebook文件体积异常增大，导致内核崩溃和保存困难。

问题现象

用户在使用Plotly 6.0.0版本时发现，即使是绘制简单的图表，生成的Notebook文件也会变得异常庞大。测试案例显示，同样的代码在5.24.1版本下生成约1MB的文件，而在6.0.0版本下却膨胀到19MB。

通过分析Notebook的JSON源文件，发现其中包含了大量重复的JavaScript代码。进一步调查表明，问题主要出在Plotly.js库的重复加载机制上。

技术分析

问题的核心在于Plotly 6.0.0版本在Jupyter Notebook中的渲染方式发生了变化：

1. 重复加载问题：首次渲染图表时，Plotly.js库会被加载两次；后续每渲染一个额外图表，都会再次完整加载Plotly.js库。

2. 渲染模式差异：6.0.0版本默认使用"offline"模式渲染器，而之前的版本可能有不同的默认设置。

3. 文件体积影响：每个Plotly.js库的完整副本大约1MB，当绘制多个图表时，文件体积会线性增长。例如40个图表可能导致150MB的超大文件。

临时解决方案

对于遇到此问题的用户，目前有以下几种临时解决方案：

1. 更改默认渲染器：在Notebook开头添加以下代码，切换到"notebook_connected"模式：

import plotly.io as pio
pio.renderers.default = "notebook_connected"

2. 降级到5.x版本：如果不需要6.0.0的新特性，可以暂时使用5.24.1版本。

3. 等待官方修复：开发团队已经确认问题并准备修复方案。

开发团队响应

Plotly开发团队迅速响应了这个问题，并确定了两个层面的解决方案：

1. 短期修复：通过PR#5112解决了Plotly.js库被重复加载的问题。

2. 长期方案：计划重新引入Jupyter mime渲染器扩展，在保持离线支持的同时控制文件大小。

对用户的影响

这个问题特别影响以下场景：

• 需要生成HTML报告并通过邮件发送的用户
• 使用ReadTheDocs等平台托管文档的用户
• 需要绘制大量图表的分析报告

对于这些用户，建议暂时采用上述临时解决方案，或关注Plotly的后续版本更新。

总结

Plotly 6.0.0在Jupyter Notebook中的文件体积问题是一个典型的版本升级带来的兼容性问题。开发团队已经定位到问题原因并着手修复，预计在后续版本中会彻底解决。在此期间，用户可以根据自身需求选择合适的临时解决方案。