如何用Python获取Excel文本框/TextFrame内容？遇COM错误求解

错误原因 #

你遇到的pywintypes.com_error是因为工作表中存在分组形状（多个形状组合而成），这类形状本身没有TextFrame2属性，直接访问会触发"This member can only be accessed for a single shape."的限制。此外，部分形状（如图片、线条）本身不包含文本框，也会引发类似错误。

可行解决代码 #

以下代码会递归处理分组形状，并跳过无文本框的形状：

import win32com.client as win32
import pythoncom

# 初始化Excel应用
excel = win32.gencache.EnsureDispatch('Excel.Application')
excel.Visible = False
# 注意用r前缀避免路径转义问题
wb = excel.Workbooks.Open(r"C:\pythonExcelScrape\uct-test22.xlsx")
sheet = wb.Worksheets(1)

def extract_shape_text(shape):
    # 处理分组形状：递归遍历子形状
    if shape.Type == 6:  # 6对应msoGroup类型
        for sub_shape in shape.GroupItems:
            extract_shape_text(sub_shape)
    else:
        # 尝试获取文本框内容，捕获不支持的情况
        try:
            text_range = shape.TextFrame2.TextRange
            if text_range.Text.strip():
                print(f"[{shape.Name}] 文本内容：{text_range.Text}")
        except pythoncom.com_error:
            # 跳过无文本的形状
            pass

# 遍历所有形状
for shp in sheet.Shapes:
    extract_shape_text(shp)

# 清理资源，避免Excel后台进程残留
wb.Close(SaveChanges=False)
excel.Quit()

关键优化点 #

• 路径转义：用r"路径"避免Windows路径中的\被解析为转义字符
• 分组处理：通过判断形状类型（Type == 6）识别分组，递归提取子形状的文本
• 异常捕获：用try-except跳过不支持文本框的形状（如图片、线条）
• 资源清理：最后关闭工作簿并退出Excel，防止后台进程占用资源

额外提示 #

如果是旧版Excel，可尝试将TextFrame2替换为TextFrame，但TextFrame2支持更多现代文本格式，优先推荐使用。

内容的提问来源于stack exchange，提问作者Lee Huat Chong