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

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

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

引言

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

理解openpyxl的图片插入机制

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

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

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

实现步骤

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

立即学习“Python免费学习笔记(深入)”;

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

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

from openpyxl import Workbookfrom 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’)。

# 将图片锚定到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列宽单位与像素的近似转换因子约为6ws.column_dimensions['A'].width = img.width / 6 # 调整第1行的行高以适应图片高度# Excel行高单位(磅)与像素的近似转换因子约为18ws.row_dimensions[1].height = img.height / 18 

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

5. 保存工作簿

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

# 保存工作簿wb.save("output_with_image_in_cell.xlsx")

完整示例代码

将以上步骤整合,得到一个完整的示例:

from openpyxl import Workbookfrom openpyxl.drawing.image import Imageimport 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.save(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指定单元格插入图片的教程的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1379838.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月14日 20:59:50
下一篇 2025年12月14日 21:00:03

相关推荐

  • 如何解决本地图片在使用 mask JS 库时出现的跨域错误?

    如何跨越localhost使用本地图片? 问题: 在本地使用mask js库时,引入本地图片会报跨域错误。 解决方案: 要解决此问题,需要使用本地服务器启动文件,以http或https协议访问图片,而不是使用file://协议。例如: python -m http.server 8000 然后,可以…

    2025年12月24日
    200
  • 使用 Mask 导入本地图片时,如何解决跨域问题?

    跨域疑难:如何解决 mask 引入本地图片产生的跨域问题? 在使用 mask 导入本地图片时,你可能会遇到令人沮丧的跨域错误。为什么会出现跨域问题呢?让我们深入了解一下: mask 框架假设你以 http(s) 协议加载你的 html 文件,而当使用 file:// 协议打开本地文件时,就会产生跨域…

    2025年12月24日
    200
  • HTML、CSS 和 JavaScript 中的简单侧边栏菜单

    构建一个简单的侧边栏菜单是一个很好的主意,它可以为您的网站添加有价值的功能和令人惊叹的外观。 侧边栏菜单对于客户找到不同项目的方式很有用,而不会让他们觉得自己有太多选择,从而创造了简单性和秩序。 今天,我将分享一个简单的 HTML、CSS 和 JavaScript 源代码来创建一个简单的侧边栏菜单。…

    2025年12月24日
    200
  • 前端代码辅助工具:如何选择最可靠的AI工具?

    前端代码辅助工具:可靠性探讨 对于前端工程师来说,在HTML、CSS和JavaScript开发中借助AI工具是司空见惯的事情。然而,并非所有工具都能提供同等的可靠性。 个性化需求 关于哪个AI工具最可靠,这个问题没有一刀切的答案。每个人的使用习惯和项目需求各不相同。以下是一些影响选择的重要因素: 立…

    2025年12月24日
    000
  • 带有 HTML、CSS 和 JavaScript 工具提示的响应式侧边导航栏

    响应式侧边导航栏不仅有助于改善网站的导航,还可以解决整齐放置链接的问题,从而增强用户体验。通过使用工具提示,可以让用户了解每个链接的功能,包括设计紧凑的情况。 在本教程中,我将解释使用 html、css、javascript 创建带有工具提示的响应式侧栏导航的完整代码。 对于那些一直想要一个干净、简…

    2025年12月24日
    000
  • 布局 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在这里查看视觉效果: 固定导航 – 布局 – codesandbox两列 – 布局 – codesandbox三列 – 布局 – codesandbox圣杯 &#8…

    2025年12月24日
    000
  • 隐藏元素 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在此处查看隐藏元素的视觉效果 – codesandbox 隐藏元素 hiding elements hiding elements hiding elements hiding elements hiding element…

    2025年12月24日
    400
  • 居中 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在此处查看垂直中心 – codesandbox 和水平中心的视觉效果。 通过 css 居中 垂直居中 centering centering centering centering centering centering立即…

    2025年12月24日 好文分享
    300
  • 如何在 Laravel 框架中轻松集成微信支付和支付宝支付?

    如何用 laravel 框架集成微信支付和支付宝支付 问题:如何在 laravel 框架中集成微信支付和支付宝支付? 回答: 建议使用 easywechat 的 laravel 版,easywechat 是一个由腾讯工程师开发的高质量微信开放平台 sdk,已被广泛地应用于许多 laravel 项目中…

    2025年12月24日
    000
  • 如何在移动端实现子 div 在父 div 内任意滑动查看?

    如何在移动端中实现让子 div 在父 div 内任意滑动查看 在移动端开发中,有时我们需要让子 div 在父 div 内任意滑动查看。然而,使用滚动条无法实现负值移动,因此需要采用其他方法。 解决方案: 使用绝对布局(absolute)或相对布局(relative):将子 div 设置为绝对或相对定…

    2025年12月24日
    000
  • 移动端嵌套 DIV 中子 DIV 如何水平滑动?

    移动端嵌套 DIV 中子 DIV 滑动 在移动端开发中,遇到这样的问题:当子 DIV 的高度小于父 DIV 时,无法在父 DIV 中水平滚动子 DIV。 无限画布 要实现子 DIV 在父 DIV 中任意滑动,需要创建一个无限画布。使用滚动无法达到负值,因此需要使用其他方法。 相对定位 一种方法是将子…

    2025年12月24日
    000
  • 移动端项目中,如何消除rem字体大小计算带来的CSS扭曲?

    移动端项目中消除rem字体大小计算带来的css扭曲 在移动端项目中,使用rem计算根节点字体大小可以实现自适应布局。但是,此方法可能会导致页面打开时出现css扭曲,这是因为页面内容在根节点字体大小赋值后重新渲染造成的。 解决方案: 要避免这种情况,将计算根节点字体大小的js脚本移动到页面的最前面,即…

    2025年12月24日
    000
  • Nuxt 移动端项目中 rem 计算导致 CSS 变形,如何解决?

    Nuxt 移动端项目中解决 rem 计算导致 CSS 变形 在 Nuxt 移动端项目中使用 rem 计算根节点字体大小时,可能会遇到一个问题:页面内容在字体大小发生变化时会重绘,导致 CSS 变形。 解决方案: 可将计算根节点字体大小的 JS 代码块置于页面最前端的 标签内,确保在其他资源加载之前执…

    2025年12月24日
    200
  • Nuxt 移动端项目使用 rem 计算字体大小导致页面变形,如何解决?

    rem 计算导致移动端页面变形的解决方法 在 nuxt 移动端项目中使用 rem 计算根节点字体大小时,页面会发生内容重绘,导致页面打开时出现样式变形。如何避免这种现象? 解决方案: 移动根节点字体大小计算代码到页面顶部,即 head 中。 原理: flexível.js 也遇到了类似问题,它的解决…

    2025年12月24日
    000
  • 形状 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在此处查看 codesandbox 的视觉效果。 通过css绘制各种形状 如何在 css 中绘制正方形、梯形、三角形、异形三角形、扇形、圆形、半圆、固定宽高比、0.5px 线? shapes 0.5px line .square { w…

    2025年12月24日
    000
  • 有哪些美观的开源数字大屏驾驶舱框架?

    开源数字大屏驾驶舱框架推荐 问题:有哪些美观的开源数字大屏驾驶舱框架? 答案: 资源包 [弗若恩智能大屏驾驶舱开发资源包](https://www.fanruan.com/resource/152) 软件 [弗若恩报表 – 数字大屏可视化组件](https://www.fanruan.c…

    2025年12月24日
    000
  • 网站底部如何实现飘彩带效果?

    网站底部飘彩带效果的 js 库实现 许多网站都会在特殊节日或活动中添加一些趣味性的视觉效果,例如点击按钮后散发的五彩缤纷的彩带。对于一个特定的网站来说,其飘彩带效果的实现方式可能有以下几个方面: 以 https://dub.sh/ 网站为例,它底部按钮点击后的彩带效果是由 javascript 库实…

    2025年12月24日
    000
  • 网站彩带效果背后是哪个JS库?

    网站彩带效果背后是哪个js库? 当你访问某些网站时,点击按钮后,屏幕上会飘出五颜六色的彩带,营造出庆祝的氛围。这些效果是通过使用javascript库实现的。 问题: 哪个javascript库能够实现网站上点击按钮散发彩带的效果? 答案: 根据给定网站的源代码分析: 可以发现,该网站使用了以下js…

    好文分享 2025年12月24日
    100
  • 产品预览卡项目

    这个项目最初是来自 Frontend Mentor 的挑战,旨在使用 HTML 和 CSS 创建响应式产品预览卡。最初的任务是设计一张具有视觉吸引力和功能性的产品卡,能够无缝适应各种屏幕尺寸。这涉及使用 CSS 媒体查询来确保布局在不同设备上保持一致且用户友好。产品卡包含产品图像、标签、标题、描述和…

    2025年12月24日
    100
  • 如何利用 echarts-gl 绘制带发光的 3D 图表?

    如何绘制带发光的 3d 图表,类似于 echarts 中的示例? 为了实现类似的 3d 图表效果,需要引入 echarts-gl 库:https://github.com/ecomfe/echarts-gl。 echarts-gl 专用于在 webgl 环境中渲染 3d 图形。它提供了各种 3d 图…

    2025年12月24日
    000

发表回复

登录后才能评论
关注微信