Python openpyxl在Excel指定单元格插入图片的教程_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Python openpyxl在Excel指定单元格插入图片的教程

2025-11-13

浏览次数：次

返回列表

Python openpyxl在Excel指定单元格插入图片的教程

本教程详细介绍了如何使用python的openpyxl库在excel的特定单元格中插入图片，而非作为浮动封面。核心方法是利用`ws.add_image`指定锚点单元格，并通过调整单元格的行高和列宽，使图片视觉上完美契合单元格尺寸，从而实现图片“嵌入”的效果。

引言

在处理Excel文件时，经常需要在特定位置插入图片。然而，对于许多Python库而言，将图片精确地“嵌入”到单元格中，使其随单元格内容一同移动、调整大小，而非仅仅作为浮动对象覆盖在工作表上，是一个常见的挑战。openpyxl库虽然强大，但其图片处理方式也需要一定的技巧才能达到预期效果。本教程将深入探讨如何利用openpyxl实现图片在Excel指定单元格的视觉“嵌入”。

理解openpyxl的图片插入机制

在Excel中，图片通常被视为“绘图对象”，它们独立于单元格内容存在。当使用openpyxl插入图片时，默认情况下，图片会作为一个浮动对象添加到工作表上。即使指定了img.anchor = 'A1'，图片也只是将其左上角锚定到A1单元格的左上角，但其大小和位置仍可能独立于A1单元格的尺寸。

要实现图片“嵌入”到单元格的效果，关键在于两个步骤：

锚定图片：将图片的左上角精确地锚定到目标单元格的左上角。
调整单元格尺寸：将目标单元格的行高和列宽调整为与图片尺寸相匹配，从而使图片在视觉上被“包裹”在单元格内部。

实现步骤

以下是使用openpyxl在Excel指定单元格插入图片的详细步骤。

1. 准备工作：导入模块与创建工作簿

首先，确保你已经安装了openpyxl库（pip install openpyxl）。然后，导入必要的模块并创建一个新的Excel工作簿和活动工作表。

from openpyxl import Workbook
from openpyxl.drawing.image import Image

# 创建一个新的工作簿
wb = Workbook()
# 获取活动工作表
ws = wb.active

2. 加载图片

指定要插入的图片路径。openpyxl的Image类可以直接加载图片文件。

# 替换为你的图片文件路径
img_path = "path/to/your/image.jpg" 

# 加载图片
img = Image(img_path)

请确保img_path是正确的，并且图片文件存在。openpyxl支持常见的图片格式，如JPEG、PNG、GIF等。

3. 锚定图片到指定单元格

使用ws.add_image()方法将图片添加到工作表。这个方法接受两个参数：图片对象和锚点单元格的引用（例如'A1'）。

Perplexity

Perplexity是一个ChatGPT和谷歌结合的超级工具，可以让你在浏览互联网时提出问题或获得即时摘要

302 查看详情 Perplexity

# 将图片锚定到A1单元格
ws.add_image(img, 'A1')

此时，图片已经添加到工作表，并且其左上角与A1单元格的左上角对齐。然而，图片的大小仍然是其原始大小，可能远超A1单元格的默认尺寸。

4. 关键步骤：调整单元格尺寸以容纳图片

为了使图片在视觉上“嵌入”到单元格中，我们需要调整目标单元格（本例中是A1）的列宽和行高，使其与图片的像素尺寸相匹配。Excel的列宽和行高单位与图片像素单位不同，因此需要进行转换。

经验表明，将图片的宽度像素除以约6，可以得到近似的Excel列宽单位；将图片的高度像素除以约18，可以得到近似的Excel行高单位。这些转换因子可能因Excel版本、DPI设置或默认字体大小而略有不同，但通常能提供一个良好的起点。

# 获取图片的宽度和高度（以像素为单位）
# 注意：openpyxl.drawing.image.Image对象在加载后会自动计算这些属性
# 如果需要精确控制，可以预先获取图片信息
# img.width 和 img.height 属性在 Image 对象中是可用的

# 调整A列的宽度以适应图片宽度
# Excel列宽单位与像素的近似转换因子约为6
ws.column_dimensions['A'].width = img.width / 6 

# 调整第1行的行高以适应图片高度
# Excel行高单位（磅）与像素的近似转换因子约为18
ws.row_dimensions[1].height = img.height / 18

通过这一步，A1单元格的尺寸将被调整为与图片尺寸大致相同，从而使图片看起来像是被“装”在单元格内部。

5. 保存工作簿

最后，保存修改后的工作簿。

# 保存工作簿
wb.s*e("output_with_image_in_cell.xlsx")

完整示例代码

将以上步骤整合，得到一个完整的示例：

from openpyxl import Workbook
from openpyxl.drawing.image import Image
import os # 用于检查文件是否存在

def add_image_to_excel_cell(image_path, cell_address, output_filename="output_with_image.xlsx"):
    """
    将图片插入到Excel的指定单元格，并调整单元格尺寸以容纳图片。

    Args:
        image_path (str): 要插入的图片文件的路径。
        cell_address (str): 目标单元格的地址，例如 'A1'。
        output_filename (str): 保存Excel文件的名称。
    """
    if not os.path.exists(image_path):
        print(f"错误：图片文件未找到 - {image_path}")
        return

    wb = Workbook()
    ws = wb.active

    try:
        img = Image(image_path)
    except Exception as e:
        print(f"错误：加载图片失败 - {e}")
        return

    # 将图片锚定到指定单元格
    ws.add_image(img, cell_address)

    # 解析单元格地址以获取列和行索引
    from openpyxl.utils import get_column_letter, column_index_from_string
    col_letter = ''.join(filter(str.isalpha, cell_address))
    row_index = int(''.join(filter(str.isdigit, cell_address)))

    # 调整列宽和行高以适应图片
    # 经验转换因子：像素到Excel列宽约6，像素到Excel行高约18
    ws.column_dimensions[col_letter].width = img.width / 6 
    ws.row_dimensions[row_index].height = img.height / 18 

    wb.s*e(output_filename)
    print(f"图片已成功插入到 {cell_address} 单元格，文件保存为 {output_filename}")

# 使用示例
# 确保 'example.jpg' 存在于脚本相同目录下，或提供完整路径
# 可以从网上下载一张图片用于测试，例如：
# import requests
# img_url = "https://via.placeholder.com/150" # 示例图片URL
# response = requests.get(img_url)
# with open("example.jpg", "wb") as f:
#     f.write(response.content)

# add_image_to_excel_cell("example.jpg", 'B2', "my_excel_with_image.xlsx")

注意事项

图片并非真正“嵌入”：尽管视觉上图片被包含在单元格内，但从Excel的内部结构来看，它仍然是一个绘图对象，只是被锚定并调整了周围单元格的尺寸。这意味着，如果用户手动调整了单元格的行高或列宽，图片可能不再完美契合。然而，openpyxl默认会设置图片的“属性”为“随单元格移动和调整大小”，这在多数情况下能满足需求。
尺寸调整的经验值：img.width / 6和img.height / 18是经验性的转换因子。它们可能需要根据具体的Excel版本、操作系统DPI设置、默认字体大小等进行微调，以达到最完美的视觉效果。如果对像素级精度有严格要求，可能需要更复杂的计算或依赖其他库（如Pillow）来获取更详细的图片信息并进行精确转换。
图片格式支持：openpyxl通常支持常见的图片格式，如JPEG、PNG、GIF等。确保你使用的图片格式是兼容的。
多图片处理：如果需要在多个单元格中插入图片，只需循环调用add_image_to_excel_cell函数，并为每个图片指定不同的单元格地址和图片路径。
性能考虑：插入大量高分辨率图片可能会显著增加Excel文件的大小，并可能影响文件打开和处理的速度。建议在插入前对图片进行适当的压缩或缩放。

总结

通过本教程，我们学习了如何利用openpyxl库在Excel的指定单元格中插入图片，并通过巧妙地调整单元格的行高和列宽，使其在视觉上达到“嵌入”的效果。理解图片在Excel中的本质（绘图对象）以及openpyxl的锚定机制是实现这一功能的关键。掌握这些技巧，将使你能够更灵活地使用Python自动化处理包含图片的Excel文档。

以上就是Python openpyxl在Excel指定单元格插入图片的教程的详细内容，更多请关注其它相关文章！

# 可以得到 # 洞口优化seo # 影楼运营营销推广方案模板 # 网站建设丿金手指稳定 # 重庆学校网站建设 # 浏阳百度关键词排名 # 菠菜关键词排名接单 # 普宁商业网站建设 # 曲阳县网站策划推广 # 河南安天网站优化服务 # 金乡线上营销推广展示 # 但其 # excel # 约为 # 而非 # 使其 # 加载 # 是一个 # 插入图片 # 单元格 # win # 操作系统 # git # python