Matplotlib中bbox_to_anchor微调致图例跳转的问题排查与解决

问题 #

使用Matplotlib时，想把图例精准定位到绘图区特定位置（比如左上角对齐绘图区），loc参数无法满足需求，改用bbox_to_anchor后，仅微调x/y值，图例就会出现大幅偏移。

原因 #

1. 坐标系默认范围差异：bbox_to_anchor默认采用figure画布坐标系（(0,0)对应画布左下角，(1,1)对应右上角），而非绘图区（axes）坐标系。画布尺寸远大于绘图区，微小的数值变化会被放大成明显的位置偏移。
2. 默认loc参数不稳定：loc默认值为'best'，会自动选择图例位置，导致bbox_to_anchor的对齐逻辑不固定，进一步加剧微调时的偏移幅度。

解决方法 #

方法1：切换到绘图区坐标系 #

通过bbox_transform=ax.transAxes将bbox_to_anchor的坐标系切换为绘图区范围（x/y取值0-1对应绘图区的左-右、下-上），同时配合loc指定图例的对齐锚点，实现精准可控的微调：

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(-2*np.pi, 2*np.pi, 0.1)
fig, ax = plt.subplots(1,1)
ax.plot(x, np.sin(x), label='Sine')
ax.plot(x, np.arctan(x), label='Inverse tan')
# 图例左上角与绘图区左上角对齐
ax.legend(bbox_to_anchor=(0, 1), loc='upper left', bbox_transform=ax.transAxes)

plt.show()

方法2：固定loc参数的对齐锚点 #

若需使用画布坐标系，固定loc参数明确图例的对齐锚点，避免默认'best'的不稳定逻辑：

# 图例左上角对齐画布(0.1, 0.9)位置
ax.legend(bbox_to_anchor=(0.1, 0.9), loc='upper left')

此时微调bbox_to_anchor数值，偏移幅度会更可控。

问题示例 #

示例1：bbox_to_anchor=(0.12,.9)

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(-2*np.pi, 2*np.pi, 0.1)
fig, ax = plt.subplots(1,1)
ax.plot(x, np.sin(x), label='Sine')
ax.plot(x, np.arctan(x), label='Inverse tan')
ax.legend(bbox_to_anchor=(0.12,.9))

plt.show()

示例2：bbox_to_anchor=(0.13,.9)

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(-2*np.pi, 2*np.pi, 0.1)
fig, ax = plt.subplots(1,1)
ax.plot(x, np.sin(x), label='Sine')
ax.plot(x, np.arctan(x), label='Inverse tan')
ax.legend(bbox_to_anchor=(0.13,.9))

plt.show()

示例3：bbox_to_anchor=(0.13,.8)

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(-2*np.pi, 2*np.pi, 0.1)
fig, ax = plt.subplots(1,1)
ax.plot(x, np.sin(x), label='Sine')
ax.plot(x, np.arctan(x), label='Inverse tan')
ax.legend(bbox_to_anchor=(0.13,.8))

plt.show()

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