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)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
高效处理变长列表数据并合并至Pandas DataFrame的教程
上一篇 2025年12月14日 20:59:50
PyQuery教程:轻松设置User-Agent请求头模拟浏览器访问
下一篇 2025年12月14日 21:00:03

相关推荐

  • 开源免费PHP工具 PHP开发效率提升利器

    推荐开源免费PHP开发工具以提升效率:VS Code、Sublime Text轻量高效,PhpStorm专业强大;调试用Xdebug、Kint、Ray;依赖管理选Composer;代码质量工具包括PHPStan、Psalm、PHP_CodeSniffer;数据库管理可用%ignore_a_1%MyA…

    2026年5月10日
    000
  • Matplotlib 地图中多类型图例的创建与优化

    Matplotlib 地图中多类型图例的创建与优化Matplotlib 地图中多类型图例的创建与优化Matplotlib 地图中多类型图例的创建与优化Matplotlib 地图中多类型图例的创建与优化

    本教程旨在解决matplotlib地图可视化中,如何在一个图例中同时展示颜色块(如区域分类)和自定义标记(如特定兴趣点)的问题。文章详细介绍了当传统`patch`对象无法正确显示标记时,如何利用`matplotlib.lines.line2d`创建标记图例句柄,并将其与颜色块图例句柄合并,从而生成一…

    2026年5月10日 用户投稿
    100
  • 利用海象运算符简化条件赋值:Python教程与最佳实践

    本文旨在探讨Python中海象运算符(:=)在条件赋值场景下的应用。通过对比传统if/else语句与海象运算符,以及条件表达式,分析海象运算符在简化代码、提高可读性方面的优势与局限性。并通过具体示例,展示如何在列表推导式等场景下合理使用海象运算符,同时强调其潜在的复杂性及替代方案,帮助开发者更好地掌…

    2026年5月10日
    000
  • 怎么在PHP代码中实现图片上传功能_PHP图片上传功能实现与安全处理教程

    首先创建含enctype的HTML表单,再用PHP接收文件,检查目录、移动临时文件,验证类型与大小,生成唯一文件名,并调整php.ini限制以确保上传成功。 如果您尝试在PHP项目中添加图片上传功能,但服务器无法正确接收或保存文件,则可能是由于表单配置、文件处理逻辑或安全限制的问题。以下是实现该功能…

    2026年5月10日
    100
  • 比特币新手教程 比特币交易平台有哪些

    比特币是一种去中心化的数字货币,基于区块链技术实现点对点交易,具有匿名性、有限发行和不可篡改等特点;新手可通过交易所购买,P2P交易获得比特币,常用平台包括Binance、OKX和Huobi;交易流程包括注册账户、实名认证、绑定支付方式、充值法币并下单购买,可选择市价单或限价单;比特币存储方式有交易…

    2026年5月10日
    000
  • RichHandler与Rich Progress集成:解决显示冲突的教程

    在使用rich库的`richhandler`进行日志输出并同时使用`progress`组件时,可能会遇到显示错乱或溢出问题。这通常是由于为`richhandler`和`progress`分别创建了独立的`console`实例导致的。解决方案是确保日志处理器和进度条组件共享同一个`console`实例…

    2026年5月10日
    000
  • 修复点击时按钮抖动:CSS垂直对齐实践

    本文探讨了在Web开发中,交互式按钮(如播放/暂停按钮)在点击时发生意外垂直位移的问题。通过分析CSS样式变化对元素布局的影响,我们发现这是由于按钮不同状态下的边框样式和内边距改变,以及默认的垂直对齐行为共同作用所致。核心解决方案是利用CSS的vertical-align属性,将其设置为middle…

    2026年5月10日
    000
  • 使用 Jupyter Notebook 进行探索性数据分析

    Jupyter Notebook通过单元格实现代码与Markdown结合,支持数据导入(pandas)、清洗(fillna)、探索(matplotlib/seaborn可视化)、统计分析(describe/corr)和特征工程,便于记录与分享分析过程。 Jupyter Notebook 是进行探索性…

    2026年5月10日
    000
  • Python命令怎样使用profile分析脚本性能 Python命令性能分析的基础教程

    使用Python的cProfile模块分析脚本性能最直接的方式是通过命令行执行python -m cProfile your_script.py,它会输出每个函数的调用次数、总耗时、累积耗时等关键指标,帮助定位性能瓶颈;为进一步分析,可将结果保存为文件python -m cProfile -o ou…

    2026年5月10日
    000
  • Python递归函数追踪与性能考量:以序列打印为例

    本文深入探讨了Python中一种递归打印序列元素的方法,并着重演示了如何通过引入缩进参数来有效追踪递归函数的执行流程和参数变化。通过实际代码示例,文章揭示了递归调用可能带来的潜在性能开销,特别是对调用栈空间的需求,以及Python默认递归深度限制可能导致的错误,为读者提供了理解和优化递归算法的实用见…

    2026年5月10日
    000
  • python中zip函数详解 python多序列压缩zip函数应用场景

    zip函数的应用场景包括:1) 同时遍历多个序列,2) 合并多个列表的数据,3) 数据分析和科学计算中的元素运算,4) 处理csv文件,5) 性能优化。zip函数是一个强大的工具,能够简化代码并提高处理多个序列时的效率。 在Python中,zip函数是一个非常有用的工具,它能够将多个可迭代对象打包成…

    2026年5月10日
    000
  • c++如何实现UDP通信_c++基于UDP的网络通信示例

    UDP通信基于套接字实现,适用于实时性要求高的场景。1. 流程包括创建套接字、绑定地址(接收方)、发送(sendto)与接收(recvfrom)数据、关闭套接字;2. 服务端监听指定端口,接收客户端消息并回传;3. 客户端发送消息至服务端并接收响应;4. 跨平台需处理Winsock初始化与库链接,编…

    2026年5月10日
    000
  • 谷歌浏览器如何截图 谷歌浏览器页面截图技巧

    谷歌浏览器如何截图 谷歌浏览器页面截图技巧谷歌浏览器如何截图 谷歌浏览器页面截图技巧谷歌浏览器如何截图 谷歌浏览器页面截图技巧谷歌浏览器如何截图 谷歌浏览器页面截图技巧

    使用谷歌浏览器的开发者工具截图步骤:1. 按ctrl+shift+i(windows/linux)或cmd+option+i(mac)打开开发者工具。2. 点击右上角三个点,选择”更多工具”,再选择”截图”。3. 选择截取整个页面。推荐的谷歌浏览器扩展…

    2026年5月10日 用户投稿
    100
  • Python中怎样使用pymongo?

    在python中使用pymongo可以轻松地与mongodb数据库进行交互。1)安装pymongo:pip install pymongo。2)连接到mongodb:from pymongo import mongoclient; client = mongoclient(‘mongod…

    2026年5月10日
    000
  • Golang使用Protobuf定义接口与消息格式

    Protobuf通过字段编号实现兼容性,新增字段可忽略、删除字段可保留编号,确保新旧版本互操作,支持服务独立演进。 在Golang项目中,利用Protobuf定义接口和消息格式,本质上是为服务间通信构建了一套高效、类型安全且跨语言的契约。它让数据结构清晰可见,RPC调用标准化,极大地简化了分布式系统…

    2026年5月10日
    000
  • JavaScript计算器开发:解决数值显示与初始化问题

    本教程深入探讨了使用JavaScript构建计算器时常见的数值显示异常问题,特别是由于类属性未初始化导致的`Cannot read properties of undefined`错误。我们将详细分析问题根源,并通过在构造函数中调用初始化方法来解决该问题,同时优化显示逻辑,确保计算器功能稳定且界面显…

    2026年5月10日
    000
  • Python 函数参数类型:如何使用可变参数和动态参数?

    python 中的参数类型:关键词参数、可变参数和动态参数 在 python 中,函数的参数可以分为以下几种类型: 关键词参数(kw)**:这些参数具有名称,并且在调用函数时明确指定。可变参数(*args):这些参数没有名称,允许函数接受任意数量的位置参数。它们将被收集到一个元组中。动态参数(kwa…

    2026年5月10日
    000
  • 使用 Ajax 和 FormData 实现文件上传及文本数据提交的完整教程

    本文旨在解决在使用 Ajax 和 FormData 进行文件上传时,遇到的 $_POST 和 $_FILES 为空的问题。通过详细的代码示例和解释,我们将展示如何正确地构建 FormData 对象,并通过 Ajax 将文件和文本数据发送到服务器端,同时避免常见的错误配置,确保数据能够成功地被 PHP…

    2026年5月10日
    000
  • NextAuth getToken 在服务端返回 null 的问题排查与解决

    问题描述 在使用 Next.js 和 NextAuth 构建应用程序时,有时需要在服务端获取用户的身份验证信息。getToken 函数是 NextAuth 提供的一个便捷方法,用于从请求中提取 JWT (JSON Web Token)。然而,在某些情况下,尤其是在使用 getServerSidePr…

    2026年5月10日
    000
  • pycharm解析器怎么添加 解析器添加详细流程

    在pycharm中添加解析器的步骤包括:1) 打开pycharm并进入设置,2) 选择project interpreter,3) 点击齿轮图标并选择add,4) 选择解析器类型并配置路径,5) 点击ok完成添加。添加解析器后,选择合适的类型和版本,配置环境变量,并利用解析器的功能提高开发效率。 在…

    2026年5月10日
    000

发表回复

登录后才能评论
关注微信