Python自动化Excel与Word：按占位符匹配填充Word表格问题求助

核心修改思路是建立Excel表头与列索引的映射关系，让替换函数通过占位符对应的表头名称，精准找到Excel中对应列的值，而非按固定列顺序替换。以下是具体修改步骤和代码示例：

1. 先建立表头-列索引映射 #

读取Excel时，先提取表头行，生成一个字典用于后续匹配占位符和列数据：

import pandas as pd
from docx import Document

# 读取Excel数据
df = pd.read_excel("你的数据文件.xlsx")
# 生成表头到列索引的映射字典，key是表头名称，value是列的索引位置
header_col_map = {header: idx for idx, header in enumerate(df.columns)}

2. 修改占位符替换函数 #

重构replace_placeholders函数，让它通过表头映射匹配占位符并替换对应值，同时覆盖Word文档的段落和表格单元格：

def replace_placeholders(doc, row_data, header_map):
    # 处理文档段落中的占位符
    for para in doc.paragraphs:
        for header, col_idx in header_map.items():
            placeholder = f"{{{{{header}}}}}"  # 生成对应表头的占位符格式，比如{{姓名}}
            if placeholder in para.text:
                # 获取当前行对应表头的数值，空值替换为空字符串
                cell_value = str(row_data.iloc[col_idx]) if pd.notna(row_data.iloc[col_idx]) else ""
                para.text = para.text.replace(placeholder, cell_value)
    
    # 处理文档表格中的占位符（关键，表格内容不在paragraphs集合里）
    for table in doc.tables:
        for table_row in table.rows:
            for cell in table_row.cells:
                for header, col_idx in header_map.items():
                    placeholder = f"{{{{{header}}}}}"
                    if placeholder in cell.text:
                        cell_value = str(row_data.iloc[col_idx]) if pd.notna(row_data.iloc[col_idx]) else ""
                        cell.text = cell.text.replace(placeholder, cell_value)

3. 分组生成文档的逻辑调整 #

按第一列唯一名称分组后，对每组数据使用上述函数进行精准替换：

# 按Excel第一列分组（假设第一列表头是"分组名称"，可根据实际修改）
grouped_data = df.groupby(df.columns[0])

for group_name, group_df in grouped_data:
    # 加载Word模板
    doc = Document("你的模板文件.docx")
    
    # 先替换分组名称占位符（比如模板里有{{分组名称}}）
    for para in doc.paragraphs:
        if "{{分组名称}}" in para.text:
            para.text = para.text.replace("{{分组名称}}", group_name)
    
    # 处理分组内的每一行数据，填充表格
    # 假设模板表格的第二行是数据占位符行，第一行是表头
    target_table = doc.tables[0]
    template_row = target_table.rows[1]
    
    for idx, row in group_df.iterrows():
        if idx != 0:
            # 复制模板行的格式（可选，保持表格样式一致）
            new_row = target_table.add_row()
            for cell_idx, template_cell in enumerate(template_row.cells):
                new_row.cells[cell_idx].width = template_cell.width
                new_row.cells[cell_idx].paragraphs[0].style = template_cell.paragraphs[0].style
        
        # 用新的替换函数处理当前行数据
        replace_placeholders(doc, row, header_col_map)
    
    # 保存生成的文档
    doc.save(f"{group_name}_表单.docx")

关键注意点 #

• Word模板中的占位符必须和Excel表头完全一致，比如Excel表头是"联系电话"，占位符就要写{{联系电话}}
• 若使用openpyxl而非pandas读取Excel，只需调整表头提取逻辑：获取第一行单元格值作为表头，再生成映射字典即可
• 空值处理：代码中已加入空值判断，避免替换时出现nan字符串

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