使用xlwings向Excel插入OLE对象（PDF）时参数失效及保存报错问题

核心问题原因 #

1. OLEObjects.Add的ClassType设为None会导致Excel无法正确识别PDF的OLE服务器，进而忽略图标相关参数
2. 图标路径使用相对路径导致Excel无法定位图标文件
3. OLE对象嵌入后未完成初始化就执行保存操作，触发Excel的COM错误
4. 不同Excel版本对PDF OLE类名的要求不同

针对性解决方案 #

1. 修复自定义图标无效及显示异常问题 #

修改OLE嵌入代码，补充必要参数：

• 指定PDF对应的OLE类名（Win7+Excel2016用"AcroExch.Document.DC"，若为Acrobat老版本用"AcroExch.Document"）
• 图标路径必须用绝对路径
• 显式设置IconIndex=0（单个图标的ICO文件默认索引为0）
• 嵌入后调整OLE对象的大小，避免显示为极小圆点

2. 修复保存报错问题 #

• 嵌入后给Excel留足OLE初始化时间（可短暂休眠或激活工作表）
• 保存时指定对应Excel版本的文件格式代码
• 确保保存路径的文件夹存在且有写入权限

修改后的完整代码示例 #

import os
import time
import xlwings as xw

# 初始化Excel应用
app = xw.App(visible=True, add_book=False)
wb = app.books.add()
sheet1 = wb.sheets[0]

# PDF路径和保存路径
pdf_path = os.path.abspath("test.pdf")
icon_path = os.path.abspath("test.ico")
new_excel_path = os.path.abspath("result.xlsx")

# 嵌入PDF并设置自定义图标
obj = sheet1.api.OLEObjects()
ole_obj = obj.Add(
    ClassType="AcroExch.Document.DC",  # 关键：指定正确的OLE类名
    Filename=pdf_path,
    Link=False,
    DisplayAsIcon=True,
    IconFileName=icon_path,  # 必须用绝对路径
    IconIndex=0,
    IconLabel="自定义PDF图标"
)

# 调整OLE对象大小和位置（避免显示为极小圆点）
ole_obj.Top = 100
ole_obj.Left = 100
ole_obj.Width = 64
ole_obj.Height = 64

# 等待OLE初始化完成，再保存
time.sleep(1)
sheet1.api.Activate()

# 指定文件格式保存（Excel2016的xlsx格式代码为51）
wb.save(new_excel_path, file_format=51)

# 关闭资源
wb.close()
app.quit()

跨环境适配（Win10+Office2021） #

若在Win10+Office2021下图标参数仍无效，尝试更换OLE类名为"AcroExch.Document"，同时确保安装了Adobe Acrobat Pro（而非Reader，Reader不支持OLE嵌入的自定义图标）。

额外注意事项 #

• ICO文件建议使用32x32或64x64的标准尺寸，避免显示变形
• 确保目标路径无特殊字符（如中文全角、空格过多），防止保存失败
• 若仍报错，检查Excel的信任中心设置，是否禁用了OLE对象嵌入

内容的提问来源于stack exchange，提问作者Egan