Linux环境下Python实现Excel指定区域转图片的方案咨询

所有方案均支持无GUI的Linux服务器环境，可完整保留原Excel的单元格样式、格式，不需要依赖Windows/Mac专属的Office组件。

前置说明：之前方案失效原因 #

• 基于xlwings的剪贴板方案：Mac/Windows下调用本地桌面Excel程序+系统剪贴板实现，Linux无桌面环境下既没有桌面Excel实例，也没有可用的GUI剪贴板，直接实例化Book必然报错
• excel2img包：底层依赖Windows系统的Excel COM接口，完全不支持跨平台
• html2image/imgkit方案：依赖带GUI的Chromium/WebKit内核，无桌面的Linux服务器默认环境缺少运行依赖
• 直接转DataFrame再生成图片：会丢失原Excel的边框、填充色、字体、合并单元格、数字格式等样式，无法满足格式保留需求

方案1：LibreOffice无头渲染+PDF裁剪（最稳定，推荐） #

原理 #

提取原Excel中目标单元格区域的内容和所有样式，生成仅包含目标区域的临时Excel文件，通过LibreOffice无头模式将临时文件转为PDF，再将PDF渲染为高清PNG图片并自动裁剪白边，全程无GUI依赖。

依赖安装 #

# 安装系统级依赖（Debian/Ubuntu系为例，CentOS/RHEL将apt替换为dnf即可）
sudo apt update && sudo apt install -y libreoffice-calc poppler-utils
# 安装Python依赖
pip install openpyxl pdf2image pillow

实现代码 #

import os
import copy
import tempfile
from openpyxl import load_workbook
from openpyxl.utils import range_boundaries, get_column_letter
from pdf2image import convert_from_path
from PIL import Image, ImageChops

def excel_range_to_png(
    source_excel_path: str,
    sheet_index: int,
    target_range: str,
    output_png_path: str,
    render_dpi: int = 220
):
    wb_source = load_workbook(source_excel_path, data_only=False)
    sheet_source = wb_source.worksheets[sheet_index]
    min_col, min_row, max_col, max_row = range_boundaries(target_range)

    with tempfile.TemporaryDirectory() as tmp_dir:
        # 生成仅包含目标区域的临时Excel
        tmp_excel_path = os.path.join(tmp_dir, "tmp_range.xlsx")
        wb_tmp = load_workbook(source_excel_path)
        # 删除所有原有sheet，新建临时sheet存放目标区域
        for exist_sheet in wb_tmp.worksheets:
            wb_tmp.remove(exist_sheet)
        sheet_tmp = wb_tmp.create_sheet("target", 0)

        # 复制列宽
        for col_idx in range(min_col, max_col + 1):
            src_col_letter = get_column_letter(col_idx)
            dest_col_letter = get_column_letter(col_idx - min_col + 1)
            sheet_tmp.column_dimensions[dest_col_letter].width = sheet_source.column_dimensions[src_col_letter].width
        # 复制行高
        for row_idx in range(min_row, max_row + 1):
            sheet_tmp.row_dimensions[row_idx - min_row + 1].height = sheet_source.row_dimensions[row_idx].height
        # 复制单元格内容、样式
        for row_idx in range(min_row, max_row + 1):
            for col_idx in range(min_col, max_col + 1):
                src_cell = sheet_source.cell(row=row_idx, column=col_idx)
                dest_cell = sheet_tmp.cell(
                    row=row_idx - min_row + 1,
                    column=col_idx - min_col + 1,
                    value=src_cell.value
                )
                if src_cell.has_style:
                    dest_cell.font = copy(src_cell.font)
                    dest_cell.border = copy(src_cell.border)
                    dest_cell.fill = copy(src_cell.fill)
                    dest_cell.number_format = src_cell.number_format
                    dest_cell.protection = copy(src_cell.protection)
                    dest_cell.alignment = copy(src_cell.alignment)
        # 复制合并单元格规则
        for merged_range in sheet_source.merged_cells.ranges:
            if (merged_range.min_col >= min_col and merged_range.max_col <= max_col
                and merged_range.min_row >= min_row and merged_range.max_row <= max_row):
                sheet_tmp.merge_cells(
                    start_row=merged_range.min_row - min_row +1,
                    start_column=merged_range.min_col - min_col +1,
                    end_row=merged_range.max_row - min_row +1,
                    end_column=merged_range.max_col - min_col +1
                )

        wb_tmp.save(tmp_excel_path)
        wb_tmp.close()

        # 临时Excel转PDF
        os.system(
            f"libreoffice --headless --convert-to pdf --outdir {tmp_dir} {tmp_excel_path} >/dev/null 2>&1"
        )
        tmp_pdf_path = os.path.join(tmp_dir, "tmp_range.pdf")
        # PDF转PNG并裁剪白边
        pdf_pages = convert_from_path(tmp_pdf_path, dpi=render_dpi)
        target_img = pdf_pages[0]
        # 自动裁剪边缘白边
        bg = Image.new(target_img.mode, target_img.size, target_img.getpixel((0,0)))
        diff = ImageChops.difference(target_img, bg)
        crop_box = diff.getbbox()
        if crop_box:
            target_img = target_img.crop(crop_box)
        target_img.save(output_png_path, "PNG")

    wb_source.close()

# 调用示例
if __name__ == "__main__":
    excel_range_to_png(
        source_excel_path="./your_file.xlsx",
        sheet_index=0,
        target_range="B2:F26",
        output_png_path="./range_output.png"
    )

方案2：改造原有xlwings代码适配Linux #

如果不想重写已有xlwings逻辑，可以启动LibreOffice无头监听服务供xlwings调用，注意必须去掉依赖系统剪贴板的截图逻辑。

步骤 #

1. 安装依赖：和方案1一致，先安装libreoffice-calc，再安装xlwings包
2. 启动LibreOffice监听端口：

soffice --headless --accept="socket,host=localhost,port=2202;urp;" --norestore --nologo --nodefault &

3. 改造原有代码，去掉ImageGrab剪贴板相关逻辑，直接通过xlwings的图片导出接口获取目标区域图片即可。

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