Python三种方案将Excel表格插入Word文档：数据重建、格式复制与OLE嵌入

脚本专家

在企业日常办公、财务审计或数据报表中，经常需要将Excel中的数据或排版好的表格同步到Word报告里。人工复制粘贴效率低且易出错，本文分享使用Spire.Doc for Python和Spire.XLS for Python组件，通过三种代码方案实现Excel表格到Word文档的集成：数据流动态构建、带格式复制、OLE对象嵌入。我们将对比每种方案的适用场景，并给出完整的Python实现代码。

## 三种方案对比

| 方案 | 原理 | 优势 | 局限 | 适用场景 |
|------|------|------|------|----------|
| 数据流动态构建 | 解析Excel单元格数据，在Word中重建表格 | 格式完全可控，Word文件体积最小 | 无法保留Excel原生公式、图表和底色 | 自动化周报生成、后台数据纯文本导出 |
| 带格式复制 | 提取Excel字体、边框、背景色等样式，渲染至Word | 视觉还原度高，保留排版色彩 | 样式解析较重，大批量处理占用内存大 | 财务资产负债表、需要严格保留颜色的技术看板 |
| OLE对象内嵌 | 将Excel文件作为二进制流内嵌到Word中 | 保持文件原样，双击可唤起Excel编辑 | 文件体积增大，非Windows环境支持有限 | 技术文档附件内嵌、需要交付给业务微调的文档 |

## 环境准备与组件安装

在Python环境中部署以下两个库：
- Spire.Doc for Python：处理Word文档结构
- Spire.XLS for Python：读取Excel数据

这两个组件独立运行，无需安装Microsoft Office。通过pip安装：

2. pip install Spire.XLS
3. pip install Spire.Doc

复制代码

安装后直接import即可使用。也可安装Spire.Office含更多组件（Spire.PDF、Spire.Presentation等）。

## 方案一：提取Excel数据并在Word中重建表格

当只需要数据，不需保留复杂底色或边框时，使用动态构建。该方法通过Excel组件读取表格数据，在Word中创建同等行列的空表格，然后循环填充数据，对Word文件体积影响最小。

2. from spire.doc import Document, AutoFitBehaviorType, FileFormat, DefaultTableStyle
3. from spire.xls import Workbook
5. # 指定输入与输出文件路径
6. excel_file = "/示例文档.xlsx"
7. word_file = "/ExcelDataToWord.docx"
9. # 创建Workbook实例并加载Excel
10. workbook = Workbook()
11. workbook.LoadFromFile(excel_file)
12. sheet = workbook.Worksheets.get_Item(0)
13. allocatedRange = sheet.AllocatedRange
15. # 创建Word文档
16. doc = Document()
17. section = doc.AddSection()
18. table = section.AddTable()
19. table.ResetCells(allocatedRange.RowCount, allocatedRange.ColumnCount)
21. # 遍历填充数据
22. for rowIndex in range(allocatedRange.RowCount):
23.     for colIndex in range(allocatedRange.ColumnCount):
24.         cell = table.Rows.get_Item(rowIndex).Cells.get_Item(colIndex)
25.         paragraph = cell.AddParagraph()
26.         textRange = paragraph.AppendText(allocatedRange.get_Item(rowIndex + 1, colIndex + 1).NumberText)
27.         textRange.CharacterFormat.FontName = "HarmonyOS Sans SC"
29. # 自适应窗口宽度并应用样式
30. table.AutoFit(AutoFitBehaviorType.AutoFitToWindow)
31. table.ApplyStyle(DefaultTableStyle.GridTable1LightAccent6)
33. doc.SaveToFile(word_file, FileFormat.Docx2019)
34. doc.Dispose()
35. workbook.Dispose()

复制代码

**核心要点：**
- sheet.AllocatedRange自动识别含数据的有效单元格范围。
- table.ResetCells()重置Word表格行列数。
- .NumberText属性读取Excel格式化后的最终文本（如千分位、百分比符号）。
- table.AutoFit(AutoFitBehaviorType.AutoFitToWindow)确保表格自适应铺满页面，防止列数过多影响展示。

## 方案二：将Excel表格带格式复制到Word文档

对于财务报表、审计报告等含合并单元格、背景色、字体的场景，需要逐一同步样式。需编写辅助函数处理合并单元格及字体样式复制。

2. from spire.xls import Workbook, HorizontalAlignType, ExcelPatternType, VerticalAlignType
3. from spire.doc import Document, Color, HorizontalAlignment, VerticalAlignment, PageOrientation, FileFormat
5. def MergeCells(worksheet, wordTable):
6.     if not worksheet.HasMergedCells:
7.         return
8.     for cell_range in worksheet.MergedCells:
9.         start_row, start_col = cell_range.Row, cell_range.Column
10.         row_count, col_count = cell_range.RowCount, cell_range.ColumnCount
11.         if col_count > 1:
12.             for row in range(start_row, start_row + row_count):
13.                 wordTable.ApplyHorizontalMerge(row - 1, start_col - 1, start_col - 1 + col_count - 1)
14.         if row_count > 1:
15.             wordTable.ApplyVerticalMerge(start_col - 1, start_row - 1, start_row - 1 + row_count - 1)
17. def CopyFormatting(tableTextRange, excelCell, wordCell):
18.     # 字体样式及颜色
19.     font = excelCell.Style.Font
20.     tableTextRange.CharacterFormat.TextColor = Color.FromRgb(font.Color.R, font.Color.G, font.Color.B)
21.     tableTextRange.CharacterFormat.FontSize = float(font.Size)
22.     tableTextRange.CharacterFormat.FontName = font.FontName
23.     tableTextRange.CharacterFormat.Bold = font.IsBold
24.     tableTextRange.CharacterFormat.Italic = font.IsItalic
25.     # 背景颜色
26.     if excelCell.Style.FillPattern != ExcelPatternType.none:
27.         wordCell.CellFormat.BackColor = Color.FromRgb(excelCell.Style.Color.R, excelCell.Style.Color.G, excelCell.Style.Color.B)
28.     # 水平对齐方式映射
29.     hAlignMap = {
30.         HorizontalAlignType.Left: HorizontalAlignment.Left,
31.         HorizontalAlignType.Center: HorizontalAlignment.Center,
32.         HorizontalAlignType.Right: HorizontalAlignment.Right
33.     }
34.     if excelCell.HorizontalAlignment in hAlignMap:
35.         tableTextRange.OwnerParagraph.Format.HorizontalAlignment = hAlignMap[excelCell.HorizontalAlignment]
36.     # 垂直对齐方式映射
37.     vAlignMap = {
38.         VerticalAlignType.Top: VerticalAlignment.Top,
39.         VerticalAlignType.Center: VerticalAlignment.Middle,
40.         VerticalAlignType.Bottom: VerticalAlignment.Bottom
41.     }
42.     if excelCell.VerticalAlignment in vAlignMap:
43.         wordCell.CellFormat.VerticalAlignment = vAlignMap[excelCell.VerticalAlignment]
45. # 主程序
46. excelFileName = "/示例文档.xlsx"
47. wordFileName = "/ExcelDataFormatToWord.docx"
48. workbook = Workbook()
49. workbook.LoadFromFile(excelFileName)
50. sheet = workbook.Worksheets.get_Item(0)
52. doc = Document()
53. section = doc.AddSection()
54. section.PageSetup.Orientation = PageOrientation.Landscape  # 宽表格推荐横向排版
55. table = section.AddTable()
56. table.ResetCells(sheet.LastRow, sheet.LastColumn)
58. MergeCells(sheet, table)
60. for r in range(1, sheet.LastRow + 1):
61.     tableRow = table.Rows.get_Item(r - 1)
62.     tableRow.Height = float(sheet.Rows.get_Item(r - 1).RowHeight)  # 同步行高
63.     for c in range(1, sheet.LastColumn + 1):
64.         eCell = sheet.Range.get_Item(r, c)
65.         wCell = table.Rows.get_Item(r - 1).Cells.get_Item(c - 1)
66.         textRange = wCell.AddParagraph().AppendText(eCell.NumberText)
67.         CopyFormatting(textRange, eCell, wCell)
69. doc.SaveToFile(wordFileName, FileFormat.Docx2019)
70. doc.Dispose()
71. workbook.Dispose()

复制代码

**核心要点：**
- MergeCells函数提取Excel的MergedCells集合，分别调用Word表格的ApplyHorizontalMerge和ApplyVerticalMerge，防止跨组件转换时结构崩坏。
- Color.FromRgb()提取颜色值实现跨文件同步。
- 复制背景色前加ExcelPatternType.none条件，防止无底色单元格被误填为黑色。
- CopyFormatting函数逐一读取Excel单元格的Font和Style属性，赋值给Word字符格式与单元格格式，保持视觉一致。

## 方案三：将Excel表格作为OLE对象内嵌到Word

当需要保留Excel原生编辑能力（如公式、图表）时，可使用OLE对象。先将Excel表格渲染为图片作为封面，再将Excel二进制文件嵌入Word。

2. from spire.doc import Document, DocPicture, FileFormat, OleObjectType
3. from spire.xls import Workbook
5. excelFileName = "示例文档.xlsx"
6. wordFileName = "/ExcelOleToWord.docx"
7. tempImageName = "SheetImage.png"
9. workbook = Workbook()
10. workbook.LoadFromFile(excelFileName)
11. sheet = workbook.Worksheets.get_Item(0)
12. sheet.ToImage(1, 1, sheet.LastRow, sheet.LastColumn).Save(tempImageName)
14. doc = Document()
15. section = doc.AddSection()
16. paragraph = section.AddParagraph()
18. pic = DocPicture(doc)
19. pic.LoadImage(tempImageName)
20. pic.Width = section.PageSetup.PageSize.Width - section.PageSetup.Margins.Left - section.PageSetup.Margins.Right
22. ole = paragraph.AppendOleObject(excelFileName, pic, OleObjectType.ExcelWorksheet)
23. ole.DisplayAsIcon = False  # 显示封面图像而非图标
25. doc.SaveToFile(wordFileName, FileFormat.Docx2019)
26. workbook.Dispose()
27. doc.Dispose()

复制代码

**核心要点：**
- sheet.ToImage()将指定表格区域转换为快照图片。
- 使用PageSize.Width - Margins.Left - Margins.Right自适应缩放，使快照横铺正文。
- paragraph.AppendOleObject()将Excel文件以OLE对象插入，绑定图片作为显示封面。
- 设置ole.DisplayAsIcon为False，确保OLE对象在Word中展示表格图像，且双击可激活Excel编辑。

## 总结

本文介绍了三种用Python将Excel表格嵌入Word文档的方案，每种方案都附有完整代码和核心解析。你可以根据实际需求选择：纯数据迁移用方案一，需保留样式用方案二，需保留编辑能力用方案三。这些代码可直接用于自动化报表生成、财务审计报告等场景，提升文档处理效率。

热心网友2

感谢楼主分享这么实用的方案，正好最近在改进报表生成流程。三种方案的对比很清晰，从轻量级数据导出到高保真格式复制再到OLE内嵌，覆盖了不同场景需求。方案一的代码我直接就能套用到周报生成里，但想请教一下：如果Excel中有多张工作表，目前只处理了第一张，是否可以通过循环sheet索引逐个添加表格到Word？另外方案二提到合并单元格处理，但代码片段似乎不完整，后续会补全吗？期待更多细节！