如何开始使用 Aspose.Cells FOSS for Python

aspose-cells-foss for Python 是一个免费且采用 MIT 许可证的库，用于创建、读取和转换电子表格文件——无需 Microsoft Office、无需本机扩展，纯 Python 来自 PyPI。

分步指南

步骤 1：安装软件包

使用 pip 从 PyPI 安装：

pip install aspose-cells-foss

验证安装：

from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")

步骤 2：导入所需类

from aspose.cells_foss import Workbook, SaveFormat

步骤 3：创建工作簿并写入数据

使用 Workbook() 创建一个新工作簿。使用 add_worksheet() 添加工作表，然后通过 cells 属性访问其单元格网格，并使用 Cells.cell(row, col) 获取一个 Cell。使用 Cell.put_value() 设置值：

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook()
ws = wb.add_worksheet("Sales")

cells = ws.cells
cells.cell(1, 1).put_value("Product")
cells.cell(1, 2).put_value("Revenue")
cells.cell(2, 1).put_value("Widget A")
cells.cell(2, 2).put_value(12500)
cells.cell(3, 1).put_value("Widget B")
cells.cell(3, 2).put_value(8750)

wb.save("sales.xlsx", SaveFormat.XLSX)
print("sales.xlsx written.")

步骤 4：读取工作簿

通过将文件路径传递给 Workbook(file_path) 来加载已有文件。使用 get_worksheet()（按索引或名称），然后通过 value 属性读取单元格值：

from aspose.cells_foss import Workbook

wb = Workbook("sales.xlsx")
ws = wb.get_worksheet(0)
cells = ws.cells

print(f"A1: {cells.cell(1, 1).value}")
print(f"B2: {cells.cell(2, 2).value}")

步骤 5：保存为其他格式

Workbook.save() 通过 SaveFormat 支持多种格式。使用 SaveFormat.CSV 生成逗号分隔的输出，使用 SaveFormat.MARKDOWN 生成 Markdown 表格：

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook("sales.xlsx")
wb.save("sales.csv", SaveFormat.CSV)
wb.save("sales.md", SaveFormat.MARKDOWN)
print("CSV and Markdown exports written.")

常见问题及解决方案

ModuleNotFoundError: No module named 'aspose' 在活动的虚拟环境中安装该软件包（参见安装指南）。确认使用 pip show aspose-cells-foss.

FileNotFoundError 加载工作簿时 使用 pathlib.Path 来构建可移植路径： Workbook(str(Path("data") / "file.xlsx")).

单元格值返回 None 读取后 单元格为空或超出范围。使用 Cell.is_empty() 在读取前进行检查 value.

CSV 输出仅包含第一张工作表 save() with SaveFormat.CSV 仅导出当前工作表。使用 set_active_worksheet() 在保存之前选择要导出的工作表。

XLSX 文件未被 Excel 打开 确保传递 SaveFormat.XLSX 显式地。若不这样，格式将根据文件扩展名推断；如果路径没有 .xlsx 扩展名，输出可能无效。

常见问题解答

aspose-cells-foss 是否需要 Microsoft Office？

不。该库以纯Python本地读取和写入电子表格文件，且不依赖 Microsoft Office、COM 自动化或 Windows API。

支持哪些Python版本？

Python 3.7 或更高。该软件包可在 Windows、macOS、Linux 和 Docker 容器上运行。

该库可免费用于商业用途吗？

是的。它在 MIT 许可证下发布。您可以出于任何目的使用、修改和再分发它，包括商业应用。

如何遍历工作表中的所有单元格？

使用 Cells.iter_rows() 按行遍历：

from aspose.cells_foss import Workbook

wb = Workbook("data.xlsx")
ws = wb.get_worksheet(0)
for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
    print(row)

我可以保存为哪些格式？

SaveFormat 支持 XLSX、CSV、TSV、MARKDOWN和JSON。使用 SaveFormat.from_extension(file_path) 可以自动从文件路径检测格式。