如何在Linux环境下用Python嵌入关联式Excel对象到Word文档

由于OLE是Windows专属技术，Linux下没有直接对应的Python库支持，所以需要换用OOXML原生规范或跨平台工具来实现需求，以下是可行方案：

方案1：通过python-docx手动构造OOXML关联对象 #

docx基于OOXML格式，可直接操作其底层XML结构来添加关联的Excel对象，无需依赖OLE库。步骤如下：

1. 生成Excel源文件
   用pandas或openpyxl生成需要关联的Excel文件，保存到指定路径（注意用户打开Word时该路径需可访问）。

2. 将Excel文件嵌入docx包
   python-docx的Document对象可以通过part属性操作docx的内部文件结构，将Excel文件添加到word/embeddings目录：

   from docx import Document
   from docx.opc.constants import RELATIONSHIP_TYPE as RT
   
   doc = Document("template.docx")
   # 添加Excel文件到embeddings部分
   excel_part = doc.part.related_parts.add(
       partname="/word/embeddings/source.xlsx",
       content_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
       blob=open("source.xlsx", "rb").read()
   )
   

3. 插入关联对象的XML标记
   在需要插入表格的位置，手动添加OOXML的OLEObject标记，设置关联属性（Type="Link"）和显示样式：

   from docx.oxml import parse_xml
   from docx.oxml.ns import qn
   
   # 构造OLE对象的XML
   ole_xml = parse_xml("""
   <w:p>
     <w:r>
       <w:object w:dxaOrig="11000" w:dyaOrig="2000">
         <o:OLEObject Type="Link" ProgID="Excel.Sheet.12" ShapeID="_x0000_i1025"
           DrawAspect="Content" ObjectID="_x0000_o1025" r:id="rId1"/>
         <v:shape id="_x0000_i1025" type="#_x0000_t202" style="width:11000;height:2000">
           <v:imagedata r:id="rId2" o:title="Source Excel"/>
         </v:shape>
       </w:object>
     </w:r>
   </w:p>
   """)
   # 获取文档的body部分，添加XML
   doc._body._body.append(ole_xml)
   # 关联Excel部分的关系ID
   doc.part.relate_to(excel_part, RT.OLE_OBJECT, rId="rId1")
   # 保存文档
   doc.save("output.docx")
   

   注意：rId需要和docx内部的关系ID对应，可通过doc.part.rels查看现有ID避免冲突。设置DrawAspect="Content"会让Word显示Excel的内容（表格形式），而非图标。

方案2：插入链接到Excel的表格（无需嵌入） #

如果不需要嵌入Excel文件，仅需关联外部Excel的特定范围，可以直接插入Word的链接表格，这是跨平台兼容的方式：

1. 准备Excel文件并确定引用范围
   比如要引用source.xlsx中Sheet1!A1:D10的范围。

2. 用python-docx插入链接字段
   Word的链接表格可以通过INCLUDETEXT字段实现，代码示例：

   from docx import Document
   from docx.oxml import OxmlElement
   from docx.oxml.ns import qn
   
   doc = Document()
   # 添加段落并插入INCLUDETEXT字段
   para = doc.add_paragraph()
   run = para.add_run()
   # 构造字段XML
   fld_char = OxmlElement('w:fldChar')
   fld_char.set(qn('w:fldCharType'), 'begin')
   run._r.append(fld_char)
   
   instr_text = OxmlElement('w:instrText')
   instr_text.text = 'INCLUDETEXT "source.xlsx" "Sheet1!A1:D10" \c "Excel.Sheet.12"'
   run._r.append(instr_text)
   
   fld_char_end = OxmlElement('w:fldChar')
   fld_char_end.set(qn('w:fldCharType'), 'end')
   run._r.append(fld_char_end)
   
   doc.save("linked_table.docx")
   

   用户打开文档时，Word会自动加载Excel指定范围的内容显示为表格，双击可打开源Excel文件编辑，更新后可刷新链接同步内容。

方案3：借助LibreOffice命令行工具 #

Linux服务器上可安装LibreOffice，利用其跨平台处理Office文档的能力，先通过mailmerge生成基础docx，再用LibreOffice插入关联对象：

1. 安装LibreOffice
   在Debian/Ubuntu上执行：sudo apt install libreoffice libreoffice-writer libreoffice-calc

2. 准备带占位符的模板
   在Word模板中预留占位符（比如{{excel_placeholder}}），用mailmerge生成填充后的docx。

3. 用LibreOffice宏替换占位符为关联Excel对象
   编写一个Basic宏来插入链接的Excel对象，然后通过命令行执行：

   soffice --headless --macro "InsertLinkedExcel('output.docx', 'source.xlsx', 'Sheet1!A1:D10')"
   

   宏示例（保存为InsertExcel.bas）：

   Sub InsertLinkedExcel(docPath As String, excelPath As String, range As String)
       Dim doc As Object
       Dim dispatcher As Object
       doc = StarDesktop.loadComponentFromURL("file://" & docPath, "_default", 0, Array())
       dispatcher = createUnoService("com.sun.star.frame.DispatchHelper")
       ' 定位到占位符位置并插入链接对象
       ' 可通过LibreOffice API实现具体定位逻辑
       doc.store()
       doc.close(True)
   End Sub
   

以上方案均无需依赖pywin32，可在Linux环境下运行，其中方案1和2基于纯Python实现，更适配Streamlit部署场景；方案3适合复杂的Office对象操作。

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