Python实现Excel图片批量导出并自动命名的方法_Python

在excel表格中批量导出图片，并按行首字段命名保存，是许多办公场景的刚需。本文提供两个完整可运行的python版本：

版本一：保持图片原始格式（png、jpg等各自保留）
版本二：统一将所有图片转换为jpg格式（节省空间、格式统一）

两个版本均实现了：按工作表分文件夹 → 根据图片所在行的a列值命名 → 自动处理重名和非法字符。

一、版本一：保持原始格式

该版本完全保留图片原始格式（.png / .jpg / .gif等），其他功能完整。

import openpyxl
from pil import image as pilimage
import io
import os


def extract_images_from_excel(excel_path, output_dir=none):
    """
    按行提取 excel 中的图片，存储到以 sheet 名称命名的文件夹下，
    图片命名为该行第一个字段的值（即a列），保持原始格式。
    """
    if output_dir is none:
        output_dir = os.path.dirname(os.path.abspath(excel_path))

    os.makedirs(output_dir, exist_ok=true)

    wb = openpyxl.load_workbook(excel_path)
    extracted_count = 0

    for sheet_name in wb.sheetnames:
        ws = wb[sheet_name]
        print(f"处理工作表: {sheet_name}")

        safe_sheet_name = "".join(
            c for c in sheet_name if c not in r'\/:*?"<>|'
        ).strip()
        sheet_dir = os.path.join(output_dir, safe_sheet_name)
        os.makedirs(sheet_dir, exist_ok=true)

        # 收集每行a列的值
        row_first_cell = {}
        for row in range(1, ws.max_row + 1):
            cell_value = ws.cell(row=row, column=1).value
            if cell_value is not none:
                row_first_cell[row] = str(cell_value)

        for image in ws._images:
            anchor = image.anchor
            if hasattr(anchor, '_from'):
                row_num = anchor._from.row + 1
            elif hasattr(anchor, 'row'):
                row_num = anchor.row + 1
            else:
                print(f"  ⚠️ 无法确定图片行号，跳过")
                continue

            first_cell_value = row_first_cell.get(row_num, none)
            if first_cell_value is none:
                print(f"  ⚠️ 第{row_num}行第一个字段为空，跳过")
                continue

            safe_name = "".join(
                c for c in first_cell_value if c not in r'\/:*?"<>|'
            ).strip()
            if not safe_name:
                safe_name = f"row_{row_num}"

            img_data = image._data()
            img = pilimage.open(io.bytesio(img_data))

            # 获取原始格式
            img_format = img.format.lower() if img.format else 'png'

            filename = f"{safe_name}.{img_format}"
            filepath = os.path.join(sheet_dir, filename)

            counter = 1
            base_name = safe_name
            while os.path.exists(filepath):
                filename = f"{base_name}_{counter}.{img_format}"
                filepath = os.path.join(sheet_dir, filename)
                counter += 1

            img.save(filepath)
            extracted_count += 1
            print(f"  ✅ 第{row_num}行 -> {safe_sheet_name}/{filename}")

    print(f"\n🎉 完成！共提取 {extracted_count} 张图片，保存至: {output_dir}")


if __name__ == '__main__':
    excel_path = 'cards.xlsx'   # 修改为你的文件
    extract_images_from_excel(excel_path, output_dir='images')

二、版本二：统一存储为jpg格式

该版本将所有提取的图片统一转换为jpg格式（背景自动填充白色以处理透明通道），可设置jpg质量。适合需要统一格式、减小体积的场景。

import openpyxl
from pil import image as pilimage
import io
import os


def extract_images_as_jpg(excel_path, output_dir=none, jpg_quality=85):
    """
    按行提取 excel 中的图片，统一转换为 jpg 格式存储。
    参数:
        excel_path: excel 文件路径
        output_dir: 输出根目录
        jpg_quality: jpg 压缩质量 (1-100)，默认85
    """
    if output_dir is none:
        output_dir = os.path.dirname(os.path.abspath(excel_path))

    os.makedirs(output_dir, exist_ok=true)

    wb = openpyxl.load_workbook(excel_path)
    extracted_count = 0

    for sheet_name in wb.sheetnames:
        ws = wb[sheet_name]
        print(f"处理工作表: {sheet_name}")

        safe_sheet_name = "".join(
            c for c in sheet_name if c not in r'\/:*?"<>|'
        ).strip()
        sheet_dir = os.path.join(output_dir, safe_sheet_name)
        os.makedirs(sheet_dir, exist_ok=true)

        # 收集每行a列的值
        row_first_cell = {}
        for row in range(1, ws.max_row + 1):
            cell_value = ws.cell(row=row, column=1).value
            if cell_value is not none:
                row_first_cell[row] = str(cell_value)

        for image in ws._images:
            anchor = image.anchor
            if hasattr(anchor, '_from'):
                row_num = anchor._from.row + 1
            elif hasattr(anchor, 'row'):
                row_num = anchor.row + 1
            else:
                print(f"  ⚠️ 无法确定图片行号，跳过")
                continue

            first_cell_value = row_first_cell.get(row_num, none)
            if first_cell_value is none:
                print(f"  ⚠️ 第{row_num}行第一个字段为空，跳过")
                continue

            safe_name = "".join(
                c for c in first_cell_value if c not in r'\/:*?"<>|'
            ).strip()
            if not safe_name:
                safe_name = f"row_{row_num}"

            img_data = image._data()
            img = pilimage.open(io.bytesio(img_data))

            # ----- 转换为 jpg 的关键代码 -----
            # 若图片为 rgba（带透明通道），需转换为 rgb（白色背景）
            if img.mode in ('rgba', 'la', 'p'):
                # 创建白色背景
                background = pilimage.new('rgb', img.size, (255, 255, 255))
                # 将原图粘贴到背景（使用透明通道作为掩码）
                if img.mode == 'p':
                    img = img.convert('rgba')
                background.paste(img, mask=img.split()[-1] if img.mode == 'rgba' else none)
                img = background
            elif img.mode != 'rgb':
                img = img.convert('rgb')
            # -----------------------------

            filename = f"{safe_name}.jpg"
            filepath = os.path.join(sheet_dir, filename)

            counter = 1
            base_name = safe_name
            while os.path.exists(filepath):
                filename = f"{base_name}_{counter}.jpg"
                filepath = os.path.join(sheet_dir, filename)
                counter += 1

            # 保存为 jpg，可指定质量
            img.save(filepath, 'jpeg', quality=jpg_quality)
            extracted_count += 1
            print(f"  ✅ 第{row_num}行 -> {safe_sheet_name}/{filename} (jpg质量={jpg_quality})")

    print(f"\n🎉 完成！共提取 {extracted_count} 张图片，已统一为jpg格式，保存至: {output_dir}")


if __name__ == '__main__':
    excel_path = 'cards.xlsx'   # 修改为你的文件
    extract_images_as_jpg(excel_path, output_dir='images_jpg', jpg_quality=85)

三、两个版本的核心区别

特性	版本一（原格式）	版本二（统一jpg）
输出扩展名	.png / .jpg / .gif 等原样保留	统一为 .jpg
透明背景处理	保留原图（png透明通道）	白色背景填充
压缩控制	无（原样保存）	可调节 quality 参数
适用场景	需要保留原始质量/透明效果	统一浏览、减小体积
输出文件夹	`images/`	`images_jpg/`

四、使用步骤（通用）

安装依赖
```
pip install openpyxl pillow
```
准备excel文件
- 确保图片是“嵌入”到单元格中的（而非浮动链接）。
- 每个含图片的行，a列必须有值，该值将作为图片文件名。
选择版本并修改路径
将代码末尾的 excel_path = 'cards.xlsx' 改为实际文件路径，可修改 output_dir。

运行脚本

python extract_images.py   # 或 extract_as_jpg.py

结果
在输出目录下会按工作表名称创建子文件夹，图片按 a列值命名存放。

五、注意事项

图片定位：脚本依赖 openpyxl 的图片锚点属性，对于合并单元格或跨行图片可能定位不准，建议将图片完整置于某一行内。
命名冲突：同一工作表中不同行的 a列值相同时，会自动添加 _1、_2 后缀。
非法字符：文件名中的 / \ : * ? " < > | 会被自动去除。
jpg 版本：原图为 gif 动图时，只会提取第一帧并转为 jpg；原图为 cmyk 模式会自动转为 rgb。

六、扩展建议

修改命名列：将 column=1 改为 column=2 即可使用b列命名。
批量处理多个excel：可在外层增加循环，依次调用函数。
支持更多输出格式：在版本二中将 'jpeg' 改为 'png' 即可输出 png，但体积较大。
保留透明通道转png：若希望统一为 png 并保留透明，可将版本二的转换代码去掉，直接保存为 png。

七、总结

本文提供了两个完整、可直接运行的 python 脚本，分别满足“原格式保留”和“统一转 jpg”的常见需求。你只需要替换文件路径即可运行，大大提升从 excel 批量导出图片的效率。选择适合自己的版本，开始自动化办公吧！

到此这篇关于python实现excel图片批量导出并自动命名的方法的文章就介绍到这了,更多相关python实现excel图片批量导出内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！

Python实现Excel图片批量导出并自动命名的方法

2026年10月02日 • Python •我要评论