Jupyter Notebook中Matplotlib 3D轴对象跨单元格scatter无显示问题

问题原因 #

Jupyter默认的inline matplotlib后端会在每个单元格执行完毕后，静态渲染当前绘图并清除figure/axes的上下文关联。当你在不同单元格分别创建3D轴和调用scatter时，后续单元格的轴对象虽然存在，但它所属的figure已脱离当前显示上下文，导致无法更新显示。

解决方案 #

方案1：使用交互式后端（推荐）

切换到widget或notebook后端，这类后端会保持figure的动态状态，跨单元格修改后自动更新显示。

• 单元格1（初始化）：

import numpy as np
import matplotlib.pyplot as plt
from mpl_toolkits.mplot3d import Axes3D

# 设置交互式后端
%matplotlib widget

# 创建全局可访问的figure和3D轴对象
fig = plt.figure()
ax = fig.add_subplot(projection='3d')

• 单元格2（添加散点）：

# 生成示例数据
x = np.random.rand(50)
y = np.random.rand(50)
z = np.random.rand(50)

# 复用之前的ax对象添加散点
ax.scatter(x, y, z)

# 手动触发刷新（部分环境可能自动刷新，此步可选）
fig.canvas.draw()

方案2：基于inline后端的静态更新

如果必须使用inline后端，可通过IPython的display函数手动更新figure显示：

• 单元格1（初始化）：

import numpy as np
import matplotlib.pyplot as plt
from mpl_toolkits.mplot3d import Axes3D
from IPython.display import display

%matplotlib inline

# 创建figure和3D轴
fig = plt.figure()
ax = fig.add_subplot(projection='3d')

# 初始显示figure
display(fig)

• 单元格2（添加散点并更新显示）：

x = np.random.rand(50)
y = np.random.rand(50)
z = np.random.rand(50)
ax.scatter(x, y, z)

# 清除旧显示并展示更新后的figure
plt.close()
display(fig)

关键注意事项 #

• 确保fig和ax对象是全局变量，或者在后续单元格中能正确引用到它们。
• 避免在不同单元格重复创建新的figure/axes，始终复用同一个对象。

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