Plotly Express图表上传至GitHub后消失问题求助
问题原因
GitHub的Jupyter Notebook渲染器不支持Plotly默认的交互式JavaScript渲染输出。本地Jupyter环境能加载Plotly的JS资源渲染动态图表,但GitHub仅解析静态内容,而默认情况下Plotly在Notebook中保存的是动态图表的JS配置代码,而非可直接显示的静态图像数据,因此上传后图表会消失。
解决方案
方案1:生成静态图片嵌入Notebook(保留本地交互性)
- 安装生成静态图片的依赖库:
pip install kaleido - 绘制图表后保存为本地图片文件:
import plotly.express as px fig = px.bar(data_frame=your_data, x='x_col', y='y_col') # 保存为png格式图片 fig.write_image('chart_1.png') - 在Notebook中用Markdown语法插入图片(替换原有
fig.show()): - 上传Notebook时,将生成的
chart_1.png等图片文件一同上传到GitHub仓库的同目录下。
方案2:全局配置Plotly输出静态图片(本地也显示静态图)
- 在Notebook开头添加配置代码,设置默认渲染器为静态png模式:
import plotly.io as pio pio.renderers.default = 'png' - 后续正常调用
fig.show(),Notebook会直接嵌入静态图片的base64数据,无需额外上传图片文件,GitHub可直接渲染显示。
方案3:临时指定静态渲染器(灵活切换交互/静态模式)
- 无需全局配置,每次显示图表时指定静态渲染器:
fig.show(renderer='png') - 这样Notebook中会嵌入静态图片数据,上传GitHub后可正常显示;若需要本地查看交互式图表,可临时切换为
fig.show(renderer='notebook')。
内容的提问来源于stack exchange,提问作者Victor Esavkin
相关产品推荐
相关产品推荐

