如何用Python和XlsxWriter让图片精准适配Excel单元格？

你的核心问题在于使用了近似的单位转换系数（col_width * 8、row_height * 1.2），导致图片与单元格的尺寸匹配存在误差。要实现图片精准贴合单元格，需要准确转换Excel单位与像素的对应关系，并配合XlsxWriter的图片插入参数进行精准控制。

关键转换公式 #

Excel的列宽和行高单位与像素的准确对应关系如下：

• 列宽：默认字体（10号Arial）下，1个列宽单位 ≈ 7.2 像素 → 单元格宽度(像素) = 列宽值 × 7.2
• 行高：行高单位是磅（Point），1磅 = 96/72 ≈ 1.3333 像素 → 单元格高度(像素) = 行高值 × 1.333333

解决方案1：拉伸图片完全贴合单元格（忽略比例） #

如果不需要保留图片原始比例，直接将图片拉伸至单元格的精确像素尺寸，插入时设置偏移为0，即可实现无留白无溢出：

import xlsxwriter
from PIL import Image
import io

workbook = xlsxwriter.Workbook('image_fit_cell_stretch.xlsx')
worksheet = workbook.add_worksheet()

# 设置单元格尺寸（Excel单位）
col_width = 25
row_height = 100
worksheet.set_column(0, 0, col_width)
worksheet.set_row(0, row_height)

# 准确转换为像素
cell_width_pix = col_width * 7.2
cell_height_pix = row_height * 1.333333

# 打开并调整图片尺寸至单元格大小
image_path = 'sample_image.jpg'
with Image.open(image_path) as img:
    # 拉伸图片到单元格精确尺寸
    img = img.resize((int(cell_width_pix), int(cell_height_pix)), Image.LANCZOS)
    buffer = io.BytesIO()
    img.save(buffer, format='JPEG')
    image_data = buffer.getvalue()

# 插入图片，设置偏移为0，尺寸匹配单元格
worksheet.insert_image(
    0, 0, image_path,
    {
        'image_data': image_data,
        'x_offset': 0,
        'y_offset': 0,
        'width': cell_width_pix,
        'height': cell_height_pix
    }
)
workbook.close()

解决方案2：保持图片比例，调整单元格适配（无留白无溢出） #

如果需要保留图片原始比例，先根据图片宽高比调整单元格的宽高，再将图片缩放至单元格尺寸：

import xlsxwriter
from PIL import Image
import io

workbook = xlsxwriter.Workbook('image_fit_cell_ratio.xlsx')
worksheet = workbook.add_worksheet()

image_path = 'sample_image.jpg'
with Image.open(image_path) as img:
    img_width, img_height = img.size
    img_aspect = img_width / img_height

# 设定基准行高，根据图片比例计算对应列宽（或反之）
base_row_height = 100  # Excel单位
calculated_col_width = base_row_height * img_aspect * (1.333333 / 7.2)

# 设置匹配图片比例的单元格尺寸
worksheet.set_column(0, 0, calculated_col_width)
worksheet.set_row(0, base_row_height)

# 转换单元格尺寸为像素
cell_width_pix = calculated_col_width * 7.2
cell_height_pix = base_row_height * 1.333333

# 缩放图片到单元格尺寸（保持比例）
img = img.resize((int(cell_width_pix), int(cell_height_pix)), Image.LANCZOS)
buffer = io.BytesIO()
img.save(buffer, format='JPEG')
image_data = buffer.getvalue()

# 插入图片
worksheet.insert_image(
    0, 0, image_path,
    {
        'image_data': image_data,
        'x_offset': 0,
        'y_offset': 0,
        'width': cell_width_pix,
        'height': cell_height_pix
    }
)
workbook.close()

核心注意事项 #

• 确保使用准确的单位转换公式，避免近似值带来的误差
• 插入图片时必须设置x_offset和y_offset为0，防止图片偏移
• 通过width和height参数强制图片尺寸与单元格完全匹配

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