安装 – Aspose FOSS Documentation

安装

Aspose.Cells FOSS for Python 安装

Aspose.Cells FOSS for Python 以标准 Python 包的形式在 PyPI 上发布，名称为 aspose-cells-foss。推荐的安装方法是 pip，它会自动处理所有依赖。

1. pip（推荐）

pip 是在 Python 上安装 Aspose.Cells FOSS 的标准方式。无需额外的工具或构建步骤。

安装最新版本：

pip install aspose-cells-foss

安装特定版本：

pip install aspose-cells-foss==26.3.0

升级现有安装：

pip install --upgrade aspose-cells-foss

2. 虚拟环境（推荐用于项目）

使用虚拟环境可以将项目依赖与系统 Python 安装隔离开来。

创建并激活虚拟环境：

##Create
python -m venv .venv

##Activate on Linux/macOS
source .venv/bin/activate

##Activate on Windows
.venv\Scripts\activate

##Install
pip install aspose-cells-foss

3. 验证安装

安装后，运行以下代码片段以确认库已正确加载：

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
workbook.worksheets[0].cells["A1"].value = "Installation verified!"
workbook.save("verify.xlsx")
print("Aspose.Cells FOSS for Python is installed correctly.")

如果文件 verify.xlsx 创建成功且没有错误，则安装完成。

4. 系统要求

需求	详情
Python 版本	3.7 或更高（推荐 3.9–3.12）
操作系统	Windows x86/x64、Linux（Ubuntu、CentOS 等）、macOS x64/ARM64
Microsoft Office	不需要
pip 依赖	`pycryptodome>=3.15.0`, `olefile>=0.46`（自动安装）

5. 包名 vs. 导入名

上下文	名称
PyPI / pip 安装	`aspose-cells-foss`
Python 导入	`from aspose.cells_foss import ...`

pip 包名称使用连字符（aspose-cells-foss），而 Python 导入使用点号表示法（aspose.cells_foss）。这遵循命名空间包约定。

6. 插件安装

markitdown-aspose-cells-plugin

扩展 Microsoft 的 MarkItDown 库，以支持 XLSX 格式：

pip install markitdown-aspose-cells-plugin

用法：

from markitdown import MarkItDown

md = MarkItDown(enable_plugins=True)
result = md.convert("spreadsheet.xlsx")
print(result.text_content)  # Spreadsheet data as Markdown tables

安装