如何在外部函数中创建Matplotlib Axes并添加至子图？

问题根源 #

plt.axes()默认会创建一个覆盖整个画布的新坐标轴，当你在已通过plt.subplots()创建的多子图布局中使用这个函数时，新生成的Axes会覆盖原有子图，导致绘图重叠。

正确解决方案：传入已有Axes对象绘图 #

不要在函数内创建新Axes，而是让函数接收外部创建好的子图Axes实例，直接在该实例上完成绘图操作。这种方式完美适配多子图布局，不会出现重叠。

示例代码 #

错误写法（导致重叠）

import matplotlib.pyplot as plt
import numpy as np

def createAxes():
    # 创建覆盖整个画布的新Axes，会重叠原有子图
    ax = plt.axes()
    x = np.linspace(0, 10, 100)
    ax.plot(x, np.sin(x))
    return ax

# 创建2x2子图布局
fig, axs = plt.subplots(2, 2)
# 赋值后重叠
axs[0,0] = createAxes()

plt.show()

正确写法

import matplotlib.pyplot as plt
import numpy as np

def createAxes(ax):
    # 直接在传入的子图Axes上绘图
    x = np.linspace(0, 10, 100)
    ax.plot(x, np.sin(x))
    ax.set_title('正弦曲线')
    return ax  # 可选返回，支持链式操作

# 创建2x2子图布局
fig, axs = plt.subplots(2, 2, figsize=(10, 8))

# 给每个子图调用函数绘图
createAxes(axs[0, 0])
createAxes(axs[0, 1])
createAxes(axs[1, 0])
createAxes(axs[1, 1])

plt.tight_layout()
plt.show()

备选方案：手动指定位置创建Axes（不推荐） #

如果确实需要在函数内创建Axes并嵌入布局，可以使用fig.add_axes()，但需要手动传入位置参数（[left, bottom, width, height]，取值范围0-1）。这种方式需要手动计算子图位置，灵活性远不如传入已有Axes。

示例代码 #

import matplotlib.pyplot as plt
import numpy as np

def createAxes(fig, rect):
    # 根据指定位置创建Axes
    ax = fig.add_axes(rect)
    x = np.linspace(0, 10, 100)
    ax.plot(x, np.cos(x))
    ax.set_title('余弦曲线')
    return ax

fig = plt.figure(figsize=(10, 8))
# 手动定义2x2布局的子图位置
createAxes(fig, [0.1, 0.55, 0.4, 0.4])  # 左上
createAxes(fig, [0.55, 0.55, 0.4, 0.4]) # 右上
createAxes(fig, [0.1, 0.1, 0.4, 0.4])   # 左下
createAxes(fig, [0.55, 0.1, 0.4, 0.4])  # 右下

plt.show()

总结 #

优先采用传入已有Axes对象的方式实现绘图函数，既符合Matplotlib的面向对象设计逻辑，又能完美适配多子图布局，彻底避免重叠问题。

内容的提问来源于stack exchange，提问作者Julia F.