![05_49_50.png](https://developer.qcloudimg.com/http-save/yehe-2596118/64f130613a1dffa29e9c7fff1cc3d1bd.png)

Excel 报表里经常需要插入图片：公司 Logo、产品效果图、电子签名、扫描件缩略图等。图片不仅要有内容，还要落在合适的单元格、大小合适、不挤压周围数据。当一批报表都要加上相同的 Logo，或者需要从模板里清理掉旧图片再换上新图时，手动操作既慢又容易出错。

本文以 Spire.XLS for Python 为例，介绍如何在指定单元格插入图片、调整图片在单元格内的偏移、读取图片的位置和尺寸、压缩图片以减小文件体积，以及批量删除工作表中的图片。

## 环境准备

安装 Spire.XLS 库：

```bash
pip install Spire.XLS
```

在脚本中引入模块：

```python
from spire.xls import *
from spire.xls.common import *
```

## 在指定单元格插入图片

`Worksheet.Pictures.Add()` 把图片插入到某个单元格位置，前两个参数是行号和列号，第三个是图片路径：

```python
workbook = Workbook()
workbook.LoadFromFile("报表.xlsx")
sheet = workbook.Worksheets[0]

# 在第 14 行第 5 列（即 E14）插入图片
sheet.Pictures.Add(14, 5, "logo.png")

workbook.SaveToFile("插入图片.xlsx", ExcelVersion.Version2010)
workbook.Dispose()
```

图片默认以原始尺寸插入，左上角对齐到指定单元格。如果图片比单元格大，会覆盖相邻区域。要避免覆盖，可以先调整目标列宽和行高，再插入图片。

![2026-09-24_173746.png](https://developer.qcloudimg.com/http-save/yehe-2596118/8aad81cbee063bce8006d43d864bd0c2.png)

## 调整图片在单元格内的偏移

插入后可以通过 `LeftColumnOffset` 和 `TopRowOffset` 微调图片在单元格内的位置，让图片与单元格边框保持一定间距：

```python
workbook = Workbook()
sheet = workbook.Worksheets[0]

sheet.Range["A1"].Text = "单元格内对齐图片："
sheet.Range["A1"].Style.VerticalAlignment = VerticalAlignType.Top

picture = sheet.Pictures.Add(1, 1, "logo.png")

# 拉宽列、拉高行，让单元格容纳图片
sheet.Columns[0].ColumnWidth = 40
sheet.Rows[0].RowHeight = 200

# 在单元格内偏移图片
picture.LeftColumnOffset = 100
picture.TopRowOffset = 25

workbook.SaveToFile("对齐图片.xlsx", ExcelVersion.Version2013)
workbook.Dispose()
```

`LeftColumnOffset` 是相对于单元格左边界的水平偏移，`TopRowOffset` 是相对于单元格上边界的垂直偏移，单位为像素。配合 `ColumnWidth` 和 `RowHeight` 先把单元格撑大，再用偏移把图片放到合适的位置，就能实现"图片在单元格内居中或留白"的效果。

![2026-09-24_174026.png](https://developer.qcloudimg.com/http-save/yehe-2596118/c717c9c29162ee3040b3c870a438fa45.png)

## 读取图片的位置和尺寸

已经存在于工作表中的图片，可以通过 `Pictures` 集合按索引取出，再读取它的位置和大小：

```python
workbook = Workbook()
workbook.LoadFromFile("带图片.xlsx")
sheet = workbook.Worksheets[0]

picture = sheet.Pictures[0]
left = picture.Left
top = picture.Top
width = picture.Width
height = picture.Height

print(f"Left={left}, Top={top}, Width={width}, Height={height}")

workbook.Dispose()
```

`Left` 和 `Top` 是图片在工作表中的绝对坐标，`Width` 和 `Height` 是图片的显示尺寸。这些值在需要把图片对齐到某个区域、或者判断图片是否越出打印范围时很有用。

## 压缩图片

插入高分辨率图片会让 Excel 文件体积迅速膨胀。`Compress()` 方法按指定质量压缩工作表中的图片，参数是 0 到 100 的整数，数值越小压缩率越高：

```python
workbook = Workbook()
workbook.LoadFromFile("大图片.xlsx")

for sheet in workbook.Worksheets:
    for picture in sheet.Pictures:
        picture.Compress(50)

workbook.SaveToFile("压缩图片.xlsx", ExcelVersion.Version2010)
workbook.Dispose()
```

外层循环遍历所有工作表，内层循环遍历每张表里的图片。`Compress(50)` 把每张图片压缩到 50% 质量。对于只需要在屏幕上查看的报表，50 通常足够；需要打印的报表可以用 75 保留更多细节。

## 删除工作表中的图片

清理模板里的旧图片，或者去掉不需要的插图，可以遍历 `Pictures` 集合逐个移除：

```python
workbook = Workbook()
workbook.LoadFromFile("模板.xlsx")
sheet = workbook.Worksheets[0]

# 倒序遍历，避免删除后索引错位
for i in range(sheet.Pictures.Count - 1, -1, -1):
    sheet.Pictures[i].Remove()

workbook.SaveToFile("删除图片.xlsx", ExcelVersion.Version2013)
workbook.Dispose()
```

删除时要从后往前遍历。每次 `Remove()` 之后集合长度会减一，正序遍历会导致索引越界或跳过某些图片。倒序循环可以安全地清空整张表的图片。

## 实用提示

- 插入图片前先设置好目标单元格的列宽和行高，可以避免图片覆盖相邻数据。
- `LeftColumnOffset` 和 `TopRowOffset` 的单位是像素，而 `ColumnWidth` 的单位是字符宽度，两者不要混用。
- 压缩图片会改变图片数据本身，属于有损操作；如果原始图片需要保留，先备份再压缩。
- 批量插入同一张 Logo 到多个工作表时，把 `Pictures.Add()` 放进 `for sheet in workbook.Worksheets` 循环即可。
- 处理完调用 `workbook.Dispose()` 释放资源。

## 总结

本文介绍了用 Python 在 Excel 中处理图片的常用操作：用 `Pictures.Add()` 在指定单元格插入图片，用 `LeftColumnOffset` 和 `TopRowOffset` 微调位置，通过 `Left`/`Top`/`Width`/`Height` 读取图片的位置和尺寸，用 `Compress()` 压缩图片减小文件体积，以及倒序遍历 `Pictures` 集合批量删除图片。把这些操作组合进报表生成脚本，图片的插入和维护也可以完全自动化。

Excel 报表里经常需要插入图片：公司 Logo、产品效果图、电子签名、扫描件缩略图等。图片不仅要有内容，还要落在合适的单元格、大小合适、不挤压周围数据。当一批报表都要加上相同的 Logo，或者需要从模板里清理掉旧图片再换上新图时，手动操作既慢又容易出错。

使用 Python 在 Excel 中处理图片

本文以 Spire.XLS for Python 为例，介绍如何在指定单元格插入图片、调整图片在单元格内的偏移、读取图片的位置和尺寸、压缩图片以减小文件体积，以及批量删除工作表中的图片。

编程语言

开发工具

后端

使用Python Spire.XLS库可在Excel单元格中精准插入图片，支持调整偏移位置、读取坐标尺寸、压缩文件体积及批量删除，有效提升报表图片处理效率，实现自动化管理。

图片压缩

代码解释

Python

2026上云采购 | AI焕新·智启新局

腾讯云BI特惠9.9元起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

使用 Python 在 Excel 中处理图片-腾讯云开发者社区-腾讯云

使用 Python 在 Excel 中处理图片

使用 Python 在 Excel 中处理图片

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐