如何通过Python API将本地图片插入Excel单元格（复刻Excel UI的「插入图片到单元格」功能）

我太懂这种困扰了——想把本地图片真正嵌入Excel单元格，就像UI里点一下「插入图片到单元格」那样，结果用openpyxl这类常用库试了半天，要么图片悬浮在单元格上面，要么只是锚定到单元格边缘，根本不是真正的“在单元格里”。

先给你明确说：目前主流的纯Python Excel库（比如openpyxl、xlsxwriter）都没有直接提供对应「插入图片到单元格」功能的API，因为这个功能在Excel的底层OOXML结构里属于特殊绑定，不是简单的添加图片对象。不过有两种可行的解决思路，看你的场景选：

方案一：调用Excel原生COM接口（Windows环境推荐，完美复刻UI功能） #

如果你的运行环境是Windows，并且安装了Excel客户端，那直接调用Excel的COM接口是最靠谱的——相当于让Python帮你点UI按钮，完全复刻「插入图片到单元格」的效果，图片会真正和单元格绑定，调整单元格大小图片也会跟着变。

步骤和代码示例 #

1. 先安装依赖：

pip install pywin32

2. 编写代码：

import win32com.client as win32
import os
import pandas as pd

# 初始化Excel应用
excel = win32.gencache.EnsureDispatch('Excel.Application')
excel.Visible = True  # 可以设为False后台运行，这里设为True方便看效果

# 新建工作簿（如果要打开已有文件就用 excel.Workbooks.Open("你的文件路径")）
wb = excel.Workbooks.Add()
ws = wb.ActiveSheet

# 读取你的DataFrame（这里用示例数据模拟）
df = pd.DataFrame({
    "key": ["foo", "bafoo"],
    "value": ["bar", 123],
    "image_path": [os.path.abspath("my_image.png"), os.path.abspath("awesome.png")]
})

# 先把DataFrame写入Excel
ws.Range("A1").CopyFromRecordset(df.to_records(index=False))
# 补写表头
header = df.columns.tolist()
for col_idx, title in enumerate(header, start=1):
    ws.Cells(1, col_idx).Value = title

# 遍历数据行，插入图片到单元格
for row in range(2, len(df)+2):  # 从第2行开始（跳过表头）
    img_path = ws.Cells(row, 3).Value
    if not os.path.exists(img_path):
        continue
    
    # 选中目标单元格（第三列，对应image_path列）
    ws.Cells(row, 3).Select()
    
    # 调用Excel原生的AddPicture2方法，这就是UI功能对应的底层API
    shape = excel.ActiveSheet.Shapes.AddPicture2(
        Filename=img_path,
        LinkToFile=False,  # 嵌入图片到文件，不是外部链接
        SaveWithDocument=True,
        Left=excel.Selection.Left,
        Top=excel.Selection.Top,
        Width=excel.Selection.Width,
        Height=excel.Selection.Height
    )
    
    # 关键设置：让图片随单元格移动和缩放，完全绑定单元格
    shape.Placement = 2  # 对应Excel里的「大小和位置随单元格而变」选项

# 保存文件
save_path = os.path.abspath("output_with_embedded_images.xlsx")
wb.SaveAs(save_path)

# 用完可以关闭Excel（如果不需要保留窗口的话）
# wb.Close()
# excel.Quit()

这个方案的优点是100%还原UI效果，图片真正属于单元格的一部分，不会出现XML报错；缺点是依赖Windows和本地Excel，跨平台性差。

方案二：纯Python库模拟（跨平台，但视觉模拟，非真正嵌入） #

如果需要跨平台（比如Linux/macOS），没法用Excel客户端，那只能退而求其次，用openpyxl这类库调整图片大小和单元格一致，然后设置锚点让图片跟着单元格移动，视觉上模拟“在单元格里”的效果。

代码示例 #

import openpyxl
from openpyxl.drawing.image import Image
import os

wb = openpyxl.Workbook()
ws = wb.active

# 写入表头和数据
ws.append(["key", "value", "image_path"])
ws.append(["foo", "bar", "my_image.png"])
ws.append(["bafoo", 123, "awesome.png"])

# 调整单元格大小（可以根据图片尺寸设置）
ws.column_dimensions['C'].width = 15  # 设置C列宽度
ws.row_dimensions[2].height = 80     # 设置第2行高度
ws.row_dimensions[3].height = 80

# 插入图片并调整到单元格大小
for row in range(2, ws.max_row+1):
    img_path = ws.cell(row=row, column=3).value
    if not os.path.exists(img_path):
        continue
    
    img = Image(img_path)
    # 设置图片大小匹配单元格
    img.width = ws.column_dimensions['C'].width * 7.5  # Excel宽度单位转像素
    img.height = ws.row_dimensions[row].height * 0.75  # Excel高度单位转像素
    
    # 锚定图片到单元格，设置随单元格移动和缩放
    img.anchor = f'C{row}'
    img.anchor._from.col = 2  # 对应C列（索引从0开始）
    img.anchor._from.row = row-1
    img.anchor.dx = 0
    img.anchor.dy = 0
    img.anchor.to.col = 2
    img.anchor.to.row = row-1
    
    ws.add_image(img)

wb.save("output_simulation.xlsx")

这个方案的优点是跨平台，不依赖Excel客户端；缺点是只是视觉上模拟，图片本质还是独立的形状对象，不是真正嵌入单元格，比如选中单元格时不会选中图片，调整单元格大小需要手动同步图片尺寸。

关于手动修改XML的说明 #

你之前尝试过修改XML但Excel报错，这是因为Excel的OOXML结构非常严谨，图片的绑定涉及到多个XML文件（比如drawings.xml、sheet1.xml、rels目录下的关系文件），稍有格式错误就会导致Excel认为文件损坏。除非你对OOXML的结构非常熟悉，否则不推荐这个方法，性价比太低。

备注：内容来源于stack exchange，提问作者Georg Heiler