在 Python 中生成 `.ods`（OpenDocument Spreadsheet）文件并实现 **表头中 A 列和 B 列的单元格合并**，我们可以使用 `odfpy` 这个库来完成操作。 `.ods` 文件格式基于 XML，支持跨行、跨列的单元格合并。我们可以通过设置 `TableCell(numbercolumnsspanned=N)` 来实现单元格横向合并。 --- ## ✅ 实现目标 - 使用 Python 创建 `.ods` 文件 - 表头中 **A1 和 B1 单元格合并为一个单元格** - 合并后的单元格显示文本 `"合并标题"` --- ## ✅ 安装依赖 首先确保安装了 `odfpy`： ```bash pip install odfpy ``` --- ## ✅ 示例代码 ```python from odf.opendocument import OpenDocumentSpreadsheet from odf.table import Table, TableRow, TableCell, CoveredTableCell from odf.text import P def create_ods_with_merged_header(output_path): """ 创建一个 .ods 文件，并实现表头中 A1 与 B1 的合并。 参数: output_path: 输出文件路径，例如："merged_header_table.ods" """ # 创建一个新的 ODS 文档 doc = OpenDocumentSpreadsheet() # 创建一张工作表 table = Table(name="Merged Header Table") # === 第一行表头：合并 A1 和 B1 === row1 = TableRow() # 合并 A1 和 B1（跨2列） merged_cell = TableCell(numbercolumnsspanned=2, valuetype='string') p = P(text="合并标题") merged_cell.addElement(p) row1.addElement(merged_cell) # C1 和 D1 正常列 for text in ["C1", "D1"]: cell = TableCell(valuetype='string') p = P(text=text) cell.addElement(p) row1.addElement(cell) # 添加第一行到表格 table.addElement(row1) # === 第二行表头：子标题 === row2 = TableRow() # 因为 A1 和 B1 已被合并，所以需要两个 CoveredTableCell 填充占位 row2.addElement(CoveredTableCell()) row2.addElement(CoveredTableCell()) # C2 和 D2 for text in ["C2", "D2"]: cell = TableCell(valuetype='string') p = P(text=text) cell.addElement(p) row2.addElement(cell) # 添加第二行到表格 table.addElement(row2) # === 数据行 === data_rows = [ ["A", "B", "C", "D"], ["1", "2", "3", "4"], ["5", "6", "7", "8"] ] for row_data in data_rows: row = TableRow() for value in row_data: cell = TableCell(valuetype='string') p = P(text=value) cell.addElement(p) row.addElement(cell) table.addElement(row) # 将表格加入文档 doc.spreadsheet.addElement(table) # 保存为 .ods 文件 doc.save(output_path) print(f".ods 文件已保存至：{output_path}") # 执行函数 if __name__ == "__main__": create_ods_with_merged_header("merged_header_table.ods") ``` --- ## ✅ 输出预览（打开后效果） | 合并标题 | | C1 | D1 | |--------------|----------|------|------| | | | C2 | D2 | | A | B | C | D | | 1 | 2 | 3 | 4 | | 5 | 6 | 7 | 8 | --- ## ✅ 技术说明 | 方法 | 描述 | |------|------| | `TableCell(numbercolumnsspanned=2)` | 设置该单元格横向跨越两列（即合并 A1 和 B1） | | `CoveredTableCell()` | 在第二行中填充已被第一行合并的空白区域 | | `P(text="...")` | 在单元格中插入文字内容 | | `TableRow()` / `Table()` | 构造行和表格对象 | | `doc.save(...)` | 保存为 `.ods` 格式的电子表格文件 | --- > ⚠️ 注意事项： > - 合并单元格会“覆盖”相邻的单元格空间，因此被覆盖的单元格必须用 `CoveredTableCell()` 占位，否则结构会出错。 > - `.ods` 是 XML 格式压缩包，你可以将 `.ods` 文件重命名为 `.zip` 解压查看其内部结构以验证是否正确实现了合并。 ---