Python编辑Word文档：段落占位符可修改，浮动文本框占位符无法编辑

尝试用Python编辑Word文档，能修改段落形式的占位符文本，但无法编辑文本框（text box）中的占位符。试过docx、win32com等工具仍未解决，后来发现之前处理的是嵌入式形状（inline shape），实际需要编辑的是浮动形状（floating shape），但docx无法处理浮动形状。当前使用的代码如下：

doc = Document(docx_file_path)

# Get the corresponding name from name_list
investor_index = list(number_dictionary.keys()).index(investor_number)
corresponding_name = name_list[investor_index]

# Find and replace text within text boxes
for shape in doc.inline_shapes:
    if shape.type == 3:  # Check if shape is a text box
        textbox = shape.text_frame
        for paragraph in textbox.paragraphs:
            if "Placeholder1" in paragraph.text:
                for run in paragraph.runs:
                    if "Placeholder1" in run.text:
                        run.text = run.text.replace("Placeholder1", corresponding_name)
                        run.font.name = 'Abhaya Libre'
                        run.font.size = Pt(14)

# Find and replace text "Placeholder3" with "Dear {corresponding name from name_list},"
for paragraph in doc.paragraphs:
    if "Placeholder3" in paragraph.text:
        for run in paragraph.runs:
            if "Placeholder3" in run.text:
                run.text = run.text.replace("Placeholder3", f"Dear {corresponding_name},")
                # Set font and size for the replaced text
                run.font.name = 'Abhaya Libre'
                run.font.size = Pt(14)

# Save the modified document
doc.save(destination_path)    

核心原因 #

python-docx库仅支持访问嵌入式形状（InlineShapes），无法读取或修改Word中的浮动形状（Shapes）——也就是你需要编辑的那种文本框。要处理浮动形状，直接调用Word的COM接口是最可靠的方案，推荐用win32com实现。

完整实现代码 #

import win32com.client as win32

# 配置参数
docx_file_path = "你的源文档路径.docx"
destination_path = "修改后的保存路径.docx"
investor_number = "目标投资者编号"
number_dictionary = {"编号1": 0, "编号2": 1}  # 替换为你的实际字典
name_list = ["张三", "李四"]  # 替换为你的实际姓名列表

# 获取对应姓名
investor_index = list(number_dictionary.keys()).index(investor_number)
corresponding_name = name_list[investor_index]

# 启动Word后台进程
word = win32.gencache.EnsureDispatch('Word.Application')
word.Visible = False  # 不显示Word窗口，后台执行
doc = word.Documents.Open(docx_file_path)

# 1. 处理所有浮动/嵌入式文本框中的占位符
for shape in doc.Shapes:
    if shape.TextFrame.HasText:  # 确认形状包含文本框内容
        text_range = shape.TextFrame.TextRange
        if "Placeholder1" in text_range.Text:
            # 替换占位符文本
            text_range.Text = text_range.Text.replace("Placeholder1", corresponding_name)
            # 设置字体样式
            text_range.Font.Name = "Abhaya Libre"
            text_range.Font.Size = 14

# 2. 处理段落中的占位符
for paragraph in doc.Paragraphs:
    para_range = paragraph.Range
    if "Placeholder3" in para_range.Text:
        para_range.Text = para_range.Text.replace("Placeholder3", f"Dear {corresponding_name},")
        para_range.Font.Name = "Abhaya Libre"
        para_range.Font.Size = 14

# 保存修改并关闭文档
doc.SaveAs(destination_path)
doc.Close()
word.Quit()

关键说明 #

• doc.Shapes会遍历文档中所有浮动形状，覆盖你需要编辑的文本框；如果需要同时处理嵌入式形状，可以再循环doc.InlineShapes，逻辑类似。
• 直接操作TextRange或Range对象，比逐段落、逐run处理更高效，且能完整保留格式设置。
• 若必须保留docx处理段落的逻辑，可以先使用docx修改段落并保存临时文件，再用win32com打开临时文件处理文本框，最后保存最终版本。

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