如何在GitHub中保存Notebook组件状态以展示Plotly图表？

GitHub的Notebook渲染器默认不支持交互式Plotly图表，因为它不会加载Plotly所需的JavaScript依赖——本地能正常显示是因为本地环境已预装这些依赖。以下是几个可行的解决步骤：

1. 生成静态Plotly输出并保存 #

在Notebook中修改渲染配置，让Plotly直接生成静态图片输出：

import plotly.express as px
import plotly.io as pio

# 设置默认渲染器为静态png
pio.renderers.default = "png"

# 生成并显示图表（此时输出为静态格式）
fig = px.bar(x=["A", "B", "C"], y=[1, 3, 2])
fig.show()

保存Notebook后重新上传GitHub，静态图表就能正常显示。

2. 手动嵌入静态图片 #

如果已经有现成的交互式图表，可先将其导出为静态文件，再插入Notebook：

# 将图表导出为png格式
fig.write_image("plotly_chart.png")

然后在Notebook中用Markdown语法插入图片：

![统计图表](plotly_chart.png)

上传时注意把导出的图片和Notebook放在同一目录下。

3. 转换为HTML文件保留交互性 #

如果需要保留图表的交互功能，可以将Notebook转换为HTML格式：

jupyter nbconvert --to html your_notebook.ipynb

将生成的HTML文件上传到GitHub，打开该文件就能正常查看交互式Plotly图表，也可以在README中添加指向这个HTML文件的说明。

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