Excel数据带格式复制到Word教程

本文旨在指导开发者如何使用Python将Excel表格数据完整地复制到Word文档中，包括单元格内容的复制以及样式的保留。我们将利用pandas库读取Excel数据，并借助python-docx库创建和格式化Word文档，从而实现将Excel数据及其样式（例如字体大小、粗体、斜体等）完整迁移到Word表格中的功能。本文提供详细的代码示例和步骤说明，帮助您轻松完成数据转换。

使用 Python 将 Excel 数据复制到 Word 并保留样式

将 Excel 数据复制到 Word 文档，并尽可能保留原有样式，是一个常见的需求。 虽然完全还原所有 Excel 样式可能非常复杂，但我们可以使用 pandas 和 python-docx 库来实现基本样式（如字体大小、粗体、斜体）的复制。

1. 准备工作

首先，确保你已经安装了必要的 Python 库：

pip install pandas python-docx

2. 代码实现

以下代码展示了如何读取 Excel 文件，创建 Word 表格，并将 Excel 数据（包括内容和部分样式）复制到 Word 表格中：

import pandas as pd
from docx import Document
from docx.shared import Pt

# 读取 Excel 文件
df = pd.read_excel("file_excel.xlsx")

# 将数据转换为列表
data_excel_to_list = df.values.tolist()

# 创建 Word 文档
doc = Document()

# 获取 Excel 表格的行数和列数
num_rows, num_cols = df.shape

# 在 Word 文档中添加表格
table = doc.add_table(rows=num_rows + 1, cols=num_cols)

# 写入表头并设置样式（粗体）
for col_num, col_name in enumerate(df.columns):
    cell = table.cell(0, col_num)
    cell.text = col_name
    #确保段落和runs存在，否则创建
    if not cell.paragraphs:
        cell.add_paragraph()
    if not cell.paragraphs[0].runs:
        cell.paragraphs[0].add_run(col_name)
    cell.paragraphs[0].runs[0].bold = True

# 写入数据并设置样式（字体大小，斜体）
for row_num, row_data in enumerate(data_excel_to_list):
    for col_num, cell_value in enumerate(row_data):
        cell = table.cell(row_num + 1, col_num)
        cell.text = str(cell_value)
        #确保段落和runs存在，否则创建
        if not cell.paragraphs:
            cell.add_paragraph()
        if not cell.paragraphs[0].runs:
            cell.paragraphs[0].add_run(str(cell_value))

        cell.paragraphs[0].runs[0].font.size = Pt(10)
        cell.paragraphs[0].runs[0].italic = True

# 保存 Word 文档
doc.save("file_word.docx")

3. 代码解释

• import pandas as pd: 导入 pandas 库，用于读取 Excel 文件。
• from docx import Document: 导入 python-docx 库，用于创建和操作 Word 文档。
• from docx.shared import Pt: 导入 Pt 类，用于设置字体大小（以磅为单位）。
• df = pd.read_excel("file_excel.xlsx"): 使用 pandas 读取名为 "file_excel.xlsx" 的 Excel 文件，并将数据存储在 DataFrame 对象 df 中。
• data_excel_to_list = df.values.tolist(): 将 DataFrame 对象 df 转换为列表，方便后续操作。
• doc = Document(): 创建一个新的 Word 文档。
• num_rows, num_cols = df.shape: 获取 Excel 表格的行数和列数。
• table = doc.add_table(rows=num_rows + 1, cols=num_cols): 在 Word 文档中添加一个表格，行数为 Excel 表格的行数加 1（用于表头），列数与 Excel 表格的列数相同。
• for col_num, col_name in enumerate(df.columns):: 循环遍历 Excel 表格的列名。
• table.cell(0, col_num).text = col_name: 将列名写入 Word 表格的表头单元格中。
• table.cell(0, col_num).paragraphs[0].runs[0].bold = True: 将表头单元格的文本设置为粗体。
• for row_num, row_data in enumerate(data_excel_to_list):: 循环遍历 Excel 表格的数据行。
• for col_num, cell_value in enumerate(row_data):: 循环遍历每一行中的单元格数据。
• table.cell(row_num + 1, col_num).text = str(cell_value): 将单元格数据写入 Word 表格的对应单元格中。
• table.cell(row_num + 1, col_num).paragraphs[0].runs[0].font.size = Pt(10): 将单元格文本的字体大小设置为 10 磅。
• table.cell(row_num + 1, col_num).paragraphs[0].runs[0].italic = True: 将单元格文本设置为斜体。
• doc.save("file_word.docx"): 将 Word 文档保存为 "file_word.docx"。

4. 注意事项

• 此代码仅复制了字体大小、粗体和斜体等基本样式。要复制更复杂的样式（例如，单元格颜色、对齐方式等），需要使用 python-docx 库更高级的功能。
• 确保 Excel 文件 "file_excel.xlsx" 和 Word 文件 "file_word.docx" 位于代码所在的目录下，或者提供完整的文件路径。
• 如果 Excel 文件包含公式，pandas 会读取公式的结果值，而不是公式本身。
• 如果Word文档已存在，请注意doc = Document("file_word.docx")，使用已存在的文档会覆盖原来的内容，需要根据需求修改代码逻辑。
• 在设置单元格样式之前，确保单元格中至少包含一个段落和一个 run 对象。如果单元格为空，需要先添加一个段落和 run，然后再设置样式。

5. 总结

通过结合 pandas 和 python-docx 库，我们可以方便地将 Excel 数据复制到 Word 文档中，并保留部分样式。 虽然无法完全还原所有 Excel 样式，但通过自定义代码，可以满足大多数基本需求。 进一步学习 python-docx 库，可以实现更复杂的 Word 文档操作和样式控制。