在使用 `python-docx` 读取 Excel 数据并基于 Word 模板批量生成报告时，需要完成以下几个关键步骤： ### ### 准备工作 首先确保安装必要的 Python 库，例如 `python-docx` 和 `openpyxl`。这两个库分别用于操作 Word 文档和 Excel 文件。 ```bash pip install python-docx openpyxl ``` ### ### 设计 Word 模板 设计一个 Word 模板（.docx），在模板中定义占位符字段，这些字段将被 Excel 中的数据替换。例如，可以使用双括号包裹的字段名，如 `{{name}}`、`{{age}}` 等[^1]。 ### ### 读取 Excel 数据 使用 `openpyxl` 或 `pandas` 读取 Excel 文件中的数据，并将其转换为易于处理的结构，例如列表或字典。 ```python import pandas as pd # 读取 Excel 文件 data = pd.read_excel('data.xlsx') # 将数据转换为字典列表 records = data.to_dict(orient='records') ``` ### ### 替换 Word 模板中的字段 通过 `python-docx` 打开 Word 模板文件，并遍历文档中的段落和表格，将占位符字段替换为实际数据。 ```python from docx import Document def replace_placeholders(paragraphs, data): for paragraph in paragraphs: for key in data: if key in paragraph.text: paragraph.text = paragraph.text.replace(key, str(data[key])) # 加载 Word 模板 template = Document('template.docx') # 遍历每条记录并生成文档 for record in records: doc = Document('template.docx') # 替换段落中的占位符 replace_placeholders(doc.paragraphs, record) # 替换表格中的占位符 for table in doc.tables: for row in table.rows: for cell in row.cells: replace_placeholders(cell.paragraphs, record) # 保存新生成的文档 doc.save(f"output_{record['name']}.docx") ``` ### ### 批量生成报告 上述代码示例中，每次循环都会加载一次模板文件，并进行字段替换，最终保存为一个新的 Word 文件。这种方式适用于批量生成个性化报告的需求[^2]。 ### ### 注意事项 - 在处理大量数据时，应考虑性能优化，例如减少对磁盘的频繁读写。 - 如果 Word 文档包含复杂的格式或嵌套表格，可能需要更细致地处理每个单元格的内容。 - 为了防止 Word 进程卡顿或崩溃，在生成文档后应及时关闭相关资源[^3]。