Matplotlib子图使用误解修正：代码错误排查求助

核心问题原因 #

你遇到的问题本质是没有为每个sns.histplot分配独立的Axes子图对象，要么是仅创建了单个子图，要么是创建了多子图但重复使用了同一个Axes，导致两个数据集的直方图绘制在同一张图上叠加。

常见错误代码示例 #

以下写法会导致叠加问题：

import seaborn as sns
import matplotlib.pyplot as plt
import numpy as np

p1 = np.random.normal(0, 1, 1000)
p2 = np.random.normal(3, 1, 1000)

# 错误：仅创建单个子图，两次绘图复用同一ax
fig, ax = plt.subplots()
sns.histplot(p1, ax=ax)
sns.histplot(p2, ax=ax)
plt.show()

或者创建了多子图但未正确获取独立Axes：

# 错误：创建1行2列子图，但未正确解构获取两个ax
fig, ax = plt.subplots(1, 2)
sns.histplot(p1, ax=ax)  # ax是数组，默认使用第一个子图
sns.histplot(p2, ax=ax)  # 继续复用同一个子图

正确代码写法 #

确保创建多子图后，为每个sns.histplot指定对应的独立Axes：

import seaborn as sns
import matplotlib.pyplot as plt
import numpy as np

# 生成测试数据
p1 = np.random.normal(0, 1, 1000)
p2 = np.random.normal(3, 1, 1000)

# 创建1行2列的子图，解构获取两个独立Axes对象
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4))

# 分别在不同Axes上绘制直方图
sns.histplot(p1, ax=ax1)
ax1.set_title('数据集p1')

sns.histplot(p2, ax=ax2)
ax2.set_title('数据集p2')

plt.tight_layout()  # 自动调整子图间距，避免标题重叠
plt.show()

关键注意事项 #

• 创建多子图时，若子图数量大于1，plt.subplots返回的Axes是数组结构，需通过(ax1, ax2)（1行2列）或axs[i][j]（多行多列）的方式获取单个子图对象。
• 必须通过sns.histplot的ax参数明确指定要绘制的目标子图，否则默认会使用当前活跃的Axes，导致绘图叠加。

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