Pyplot 3D散点图z轴异常：plt.scatter为何未正确渲染z值？

问题现象 #

使用Matplotlib全局接口plt.scatter(x,y,z)绘制3D散点图时，所有点的z值会被强制渲染在z=0平面，完全忽略传入的z参数；但将3D轴对象赋值给变量后，调用ax.scatter(x,y,z)就能正确显示不同z值对应的空间位置。

异常代码示例 #

x = [1, 1]
y = [1, 1]
z = [-10, 10]

fig = plt.figure(figsize=(16, 18))
plt.axes(projection ="3d")
plt.scatter(x, y, z, color='k')

plt.show()

正常代码示例 #

x = [1, 1]
y = [1, 1]
z = [-10, 10]

fig = plt.figure(figsize=(16, 18))
ax = plt.axes(projection ="3d")
ax.scatter(x, y, z, color='k')

plt.show()

原因解析 #

plt.scatter()属于Matplotlib的全局pyplot接口，默认绑定当前上下文的2D轴对象进行绘制。即便提前用plt.axes(projection="3d")创建了3D轴，plt.scatter()也不会自动切换到这个3D轴，而是隐式使用2D轴（若当前无活跃2D轴，甚至会重新创建）。在2D轴的绘制逻辑中，z参数会被直接忽略，所有点自然落在z=0平面。

而ax.scatter()是直接调用3D轴对象的实例方法，会严格按照3D绘图逻辑处理x、y、z三个维度的参数，因此能正确渲染点在3D空间中的位置。

解决方案 #

• 显式获取3D轴对象并调用其scatter()方法，这是Matplotlib官方推荐的面向对象绘图风格，也是最稳妥的方式。
• 若坚持使用全局接口，可通过plt.gca()获取当前活跃的3D轴后再调用scatter：

x = [1, 1]
y = [1, 1]
z = [-10, 10]

fig = plt.figure(figsize=(16, 18))
plt.axes(projection ="3d")
plt.gca().scatter(x, y, z, color='k')

plt.show()

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