Matplotlib绘制Pandas DataFrame表格时标题重叠如何解决

• ax.axis('tight') 仅适配常规坐标轴绘图元素，ax.table()生成的表格不会被纳入自动布局计算范围，表格行数增加时会自动挤占坐标轴顶部预留的标题空间
• 之前设置的y=1是坐标轴相对坐标系的上边界位置，当表格顶到坐标轴上沿时，标题自然会和表格重叠；pad参数控制的是标题和坐标轴上边界的间距，坐标轴本身顶部没有预留冗余空间时，调整pad不会有效果
• tight_layout无法识别关闭显示的坐标轴、以及table元素的边界，因此触发布局未生效的警告，无法自动调整边距

核心逻辑是先强制渲染画布拿到表格的实际高度，动态调整坐标轴位置给标题腾空间，不需要依赖自动布局，适配任意行数的DataFrame：

fig, ax = plt.subplots()
fig.patch.set_visible(False)
ax.axis('off')
# 移除原代码的ax.axis('tight')，避免提前锁死坐标轴范围

the_table = ax.table(
    cellText=df_to_plot.values,
    colLabels=df_to_plot.columns,
    loc='center'
)
the_table.auto_set_font_size(False)
the_table.set_fontsize(7)

# 强制渲染画布，获取表格实际占用的空间坐标
fig.canvas.draw()
renderer = fig.canvas.get_renderer()
# 将表格的像素坐标转换为画布归一化坐标
table_bbox = the_table.get_window_extent(renderer).transformed(fig.transFigure.inverted())
# 标题预留高度，可根据字体大小调整，7号字用0.05左右即可
title_reserve_space = 0.05
# 调整坐标轴位置，高度刚好匹配表格高度，顶部留出标题空间
ax.set_position([
    ax.get_position().x0,
    ax.get_position().y0,
    ax.get_position().width,
    table_bbox.y1 - ax.get_position().y0
])
# 直接用画布坐标设置标题位置，保证在表格正上方居中
ax.set_title(
    f"{title}",
    y=table_bbox.y1 + title_reserve_space / 2,
    pad=0,
    transform=fig.transFigure,
    ha="center"
)

# 不需要再调用tight_layout，手动计算的位置不会出现偏移
fig.savefig(save_name, bbox_inches='tight')

• 如果觉得标题和表格间距太近/太远，直接修改title_reserve_space的数值即可，取值范围建议在0.03~0.08之间
• 该方案会自动适配任意行数、列数的DataFrame表格，表格不会超出PDF边界，标题始终和表格保持固定间距，不会重叠
• 移除原代码中标题字符串末尾加的\n，手动控制位置时不需要额外加换行腾空间

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