如何解决Python中用ReportLab插入PDF的图片变形问题

问题原因 #

图片变形的核心是宽高比不匹配，具体出现在两个环节：

1. Matplotlib存图环节：未设置bbox_inches='tight'时，保存的图片会带大量默认空白，导致实际像素宽高比与图表视觉比例不符；若未明确figsize和dpi，图片尺寸偏离预期，后续缩放容易出错。
2. ReportLab插入环节：手动指定与原图宽高比不一致的width和height，会强制拉伸图片；未正确获取原图尺寸就盲目缩放，也会破坏比例。

解决方案 #

1. 优化Matplotlib图表保存 #

确保保存的图片无多余空白、宽高比符合预期：

import matplotlib.pyplot as plt
import seaborn as sns

# 提前设置画布尺寸，明确宽高比（示例为2:1）
plt.figure(figsize=(8, 4))
sns.lineplot(x=[1,2,3,4], y=[10,20,15,25])
plt.title('Sample Plot')
plt.xlabel('X Axis')
plt.ylabel('Y Axis')

# 调整布局避免元素裁剪，保存时去除空白并设置高dpi保证清晰度
plt.tight_layout()
plt.savefig('plot.png', dpi=300, bbox_inches='tight')
plt.close()

2. 按比例插入图片到PDF #

通过获取原图尺寸，计算符合比例的显示参数，避免强制拉伸：

from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import letter
from reportlab.lib.utils import ImageReader

# 初始化PDF画布
c = canvas.Canvas('report.pdf', pagesize=letter)
page_w, page_h = letter

# 获取图片原始尺寸（ReportLab默认单位为点，1英寸=72点）
img_reader = ImageReader('plot.png')
img_w, img_h = img_reader.getSize()

# 设置图片最大显示宽度（示例为页面宽度的80%）
max_display_w = page_w * 0.8
# 按原始比例计算对应高度
display_h = (max_display_w / img_w) * img_h

# 计算居中位置（可选）
x_pos = (page_w - max_display_w) / 2
y_pos = page_h - display_h - 50  # 距离顶部50点

# 插入图片，使用计算后的宽高保持比例
c.drawImage(img_reader, x_pos, y_pos, width=max_display_w, height=display_h)

c.save()

简化插入方式 #

如果不需要精确控制尺寸，也可以只指定一个维度（如width），让ReportLab自动按比例计算另一个维度：

# 仅指定宽度，高度自动匹配比例
c.drawImage('plot.png', 100, 500, width=400)

关键说明 #

• bbox_inches='tight'：移除Matplotlib保存图片时的默认空白，确保图片实际宽高比与图表一致；
• dpi=300：保证图片在PDF中显示清晰，避免模糊；
• ImageReader.getSize()：直接获取图片在ReportLab中的尺寸（点），避免像素与点的单位转换错误；
• 始终保持宽高比：无论是手动计算还是依赖ReportLab自动处理，都不要同时指定与原图比例不符的宽高值。

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