Python如何将含长文本的Dataframe带格式保存为PNG表格

优先选择以下3种易上手的工具，按新手友好度排序：

• dataframe-image：专门用于Dataframe转图片的工具，内置自动排版、格式适配逻辑，代码量最少
• matplotlib：Python可视化基础库，可自定义程度高，无需额外安装专用工具
• plotly：交互式可视化工具，适合需要先手动调整表格格式再导出的场景

方法1：使用dataframe-image（最推荐新手使用） #

安装依赖 #

执行命令：
pip install dataframe-image pandas

操作代码 #

import pandas as pd
import dataframe_image as dfi

# 1. 读取/生成你自己的Dataframe，此处为示例数据
df = pd.DataFrame({
    "序号": [1,2,3],
    "长文本内容": [
        "这是一段非常长的测试文本，用来验证长文本是否可以自动换行展示不会溢出",
        "第二段长文本，包含多个信息点，比如数据统计、结论说明等内容",
        "第三段长文本，用于测试不同长度内容的排版效果"
    ],
    "数值结果": [92.5, 87.1, 95.3]
})

# 2. （可选）给Dataframe添加自定义格式，比如高亮最大值、修改表头样式
styled_df = df.style \
    .highlight_max(subset=["数值结果"], color="#90EE90") \
    .set_table_styles([{
        "selector": "th",
        "props": [("background-color", "#4F81BD"), ("color", "white"), ("font-weight", "bold")]
    }])

# 3. 导出为PNG图片，自动处理长文本换行
dfi.export(
    styled_df, # 也可以直接传未格式化的df
    "表格导出结果.png",
    dpi=300, # 调整分辨率避免模糊
    table_conversion="matplotlib" # 适配Windows系统可加这个参数
)

方法2：使用matplotlib原生实现（无额外专用依赖） #

安装依赖 #

执行命令：
pip install matplotlib pandas

操作代码 #

import pandas as pd
import matplotlib.pyplot as plt

# 1. 处理Dataframe，给长文本加自动换行，每行最多20个字符
df = pd.DataFrame({
    "序号": [1,2,3],
    "长文本内容": [
        "这是一段非常长的测试文本，用来验证长文本是否可以自动换行展示不会溢出",
        "第二段长文本，包含多个信息点，比如数据统计、结论说明等内容",
        "第三段长文本，用于测试不同长度内容的排版效果"
    ],
    "数值结果": [92.5, 87.1, 95.3]
})
df["长文本内容"] = df["长文本内容"].str.wrap(20)

# 2. 绘制表格
fig, ax = plt.subplots(figsize=(10, 6)) # 调整画布大小适配内容
ax.axis("off")
table = ax.table(
    cellText=df.values,
    colLabels=df.columns,
    cellLoc="left",
    loc="center",
    colWidths=[0.1, 0.6, 0.3] # 手动设置每列宽度，适配长文本
)

# 3. 调整样式
table.auto_set_font_size(False)
table.set_fontsize(10)
table.scale(1.2, 2) # 调整行高避免内容拥挤

# 4. 保存图片
plt.savefig("表格导出结果.png", dpi=300, bbox_inches="tight")
plt.close()

• 长文本溢出：提前对文本列做换行处理，代码为df['列名'] = df['列名'].str.wrap(每行字符数)
• 导出内容被截断：保存时添加bbox_inches="tight"参数
• 图片模糊：导出时设置dpi=300或更高的分辨率参数

内容的提问来源于stack exchange，提问作者Subhanu g.j.