开发者指南

Aspose.Cells FOSS for Python 是一个免费、开源的库，用于以编程方式处理电子表格。无论您是构建数据管道、生成自动化报告、将机器学习结果导出到 Excel，还是将工作簿转换为 Markdown 用于文档管道，Aspose.Cells FOSS 都提供了全面的 API，覆盖电子表格操作的每一层，而无需 Microsoft Office。

关键特性

工作簿和工作表操作

从头创建新的工作簿或打开现有的 XLSX 或 CSV 文件。使用简洁、符合 Python 风格的 API 浏览 Workbook → Worksheets → Cells → Cell 层次结构。使用 workbook.add_worksheet(name) 和 workbook.remove_worksheet(index_or_name) 添加、重命名和删除工作表。通过地址（ws.cells["A1"]）访问单元格，直接设置值，并遍历已填充的范围。

Cell Styling and Formatting

对单元格进行细粒度的格式化。通过 Font 类控制字体族、大小、颜色、粗体、斜体、下划线和删除线。使用 cell.style.fill.set_solid_fill("FFRRGGBB") 设置背景填充。颜色以 8 位字符的 AARRGGBB 十六进制字符串表示，不带 # 前缀（例如，"FFFF0000" 表示不透明的红色）。

图表创建与可视化

使用专用方法（如 ws.charts.add_bar(top_row, left_col, bottom_row, right_col) 和 ws.charts.add_line(...)）向工作表添加柱形图、折线图、条形图和饼图。将图表标题设置为字符串（chart.title = "My Chart"），在图表级别配置类别数据（chart.category_data = "A2:A6"），并添加命名系列（chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")）。

公式支持

通过设置 cell.formula = "=SUM(A1:A5)" 或构建 Cell(None, "=SUM(A1:A5)") 并将其分配给 cells 集合来输入 Excel 兼容的公式。

Multi-Format Export

使用单个 workbook.save(path) 调用将工作簿导出为 XLSX、CSV、TSV、Markdown 和 JSON。
使用 SaveFormat 常量进行显式控制：SaveFormat.XLSX、SaveFormat.CSV、SaveFormat.TSV、SaveFormat.MARKDOWN、SaveFormat.JSON。
使用 MarkdownSaveOptions 实现细粒度的 Markdown 输出（对齐、标题级别、工作表索引）。
使用 MarkdownHandler.save_markdown_to_string(wb) 进行内存中的 Markdown 生成。

注意: Aspose.Cells FOSS 导出为 XLSX、CSV、TSV、Markdown 和 JSON。PDF、HTML、PNG、TIFF、DOCX 和 PPTX 导出不属于 FOSS 库。

Plugin Ecosystem

可选的 markitdown-aspose-cells-plugin 包与 Microsoft 的 MarkItDown 库集成，以添加 XLSX 读取支持。使用 pip install markitdown-aspose-cells-plugin 安装它，并通过 MarkItDown API 透明地使用。

入门

安装 

pip install aspose-cells-foss

你好，世界 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Hello, Aspose.Cells FOSS!"
ws.cells["A2"].value = 42
workbook.save("hello.xlsx")

导出为 Markdown 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88

workbook.save_as_markdown("results.md")

创建柱形图 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

data = [("Q1", 50), ("Q2", 100), ("Q3", 170), ("Q4", 300)]
for i, (label, value) in enumerate(data):
    ws.cells[f"A{i+2}"].value = label
    ws.cells[f"B{i+2}"].value = value

chart = ws.charts.add_bar(6, 0, 20, 8)
chart.title = "Quarterly Revenue"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")

workbook.save("chart.xlsx")

样式单元格 

from aspose.cells_foss import Workbook, Cell, Font

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"] = Cell("Revenue Report")

cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FFFFFFFF"   # White text (AARRGGBB, no #)
cell.style.fill.set_solid_fill("FF1E64C8")  # Blue background

workbook.save("styled.xlsx")

可用指南

  • 电子表格格式导出 — 在 XLSX、CSV、TSV、Markdown 和 JSON 之间导出工作簿。
  • 公式计算 — 以编程方式输入并计算兼容 Excel 的公式。
  • 电子表格操作 — 工作簿创建、单元格操作、范围处理以及样式设置。
  • 快速入门 — 安装、系统要求以及创建您的第一个工作簿。

另请参见

 中文