matplotlib中plt.text修改Y参数不影响文本位置的问题

plt.text()修改y坐标失效、纯净环境文本不显示，是坐标系默认规则+不同环境自动裁剪/边距配置差异共同导致的：

• plt.text()默认使用数据坐标系，坐标单位和绘图轴的数值单位完全一致。如果想把文本放到图表下方，设置的y值实际已经落在当前绘图轴（axes）的默认显示范围外。
• 不同环境对轴外元素的处理逻辑不同：
  • 你当前使用的环境会自动扩展底部边距，刚好把溢出的文本纳入画布范围。这个自动适配逻辑会始终保持文本和图表底部的最小间距，所以无论你把y值改得多小（把文本往更下方挪），边距都会自动跟着扩，看起来就像y参数完全没生效。
  • 搭配matplotlib-inline==0.1.3的纯净IPython环境，默认开启了紧凑裁剪（bbox_inches='tight'），所有落在axes初始范围外的元素会被直接裁掉，所以完全看不到注释文本。
  • 其他可以正常复现y值调整效果的环境，要么提前预留了足够的底部边距，要么关闭了自动裁剪、自动适配边距的逻辑。

三种方案任选即可，优先选第一种，兼容性最好，不需要额外计算坐标值。

方案1：切换为轴相对坐标系（推荐） #

给plt.text()传入transform=plt.gca().transAxes参数，将坐标系切换为相对于axes的比例坐标：此时x、y的取值范围为[0,1]，分别对应axes的左->右、下->上边界，要放到图表下方只需把y设为负数即可。最后手动预留足够的底部边距，避免文本被裁：

# 你的原有绘图逻辑
# import seaborn as sns
# import pandas as pd
# import matplotlib.pyplot as plt
# df = pd.DataFrame(...)
# sns.barplot(data=df, x="xxx", y="xxx")

# 添加注释：x=0.5表示水平居中，y=-0.12表示在axes下方0.12倍axes高度的位置
plt.text(
    x=0.5, 
    y=-0.12, 
    s="你要添加的注释内容", 
    ha="center",  # 水平居中对齐
    transform=plt.gca().transAxes
)
# 手动调整底部边距，给注释留出足够空间
plt.subplots_adjust(bottom=0.2)

这种写法下调整y值（比如从-0.12改成-0.2），文本垂直位置会正常响应变化，不会出现贴边不动的问题，且全版本matplotlib兼容。

方案2：手动扩展数据坐标范围 #

如果需要继续使用数据坐标系，手动把y轴的下限设置到比注释的y值更小的位置，关闭自动适配即可：

ax = plt.gca()
# 比如原y轴下限是0，就把下限设到足够容纳注释的位置，比如-2
ax.set_ylim(bottom=-2)
# 添加注释，此时y值在-2~0之间调整就可以正常改变文本位置
plt.text(x=目标x坐标, y=-1, s="你要添加的注释内容", ha="center")

方案3：修改IPython环境默认裁剪配置 #

在绘图代码最开头添加以下配置，关闭自动紧凑裁剪：

plt.rcParams["figure.autolayout"] = False
%config InlineBackend.print_figure_kwargs = {"bbox_inches": None}

配置生效后，轴外的文本不会被自动裁剪，y参数的调整效果可以正常显示。

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