Jak začít s Aspose.Cells FOSS pro Python

aspose-cells-foss Python je knihovna zdarma, licencovaná MIT pro tvorbu, čtení a… konverze souborů s rozhraním – žádný požadovaný Microsoft Office, žádné původní rozšíření, čisté Python z PyPy.

Krok za krokem průvodce

Krok 1: Nainstalujte balíček

Instalace z PyPI s pipem:

pip install aspose-cells-foss>=26.3.1

Zkontrolujte instalaci:

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

Krok 2: Import požadovaných tříd

from aspose.cells_foss import Workbook, SaveFormat

Krok 3: Vytvořte pracovní knihu a napište data

Použití Workbook() vytvořit novou pracovní knihu. přidat pracovní desku s add_worksheet(),A pak přístup k jeho buněčné síti prostřednictvím cells majetek a využití Cells.cell(row, col) Aby se dostalo A Cell.- nastavení hodnot s 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.")

Krok 4: Přečtěte si pracovní knihu zpět

Stáhnout stávající soubor tím, že přejdete cestu soubory na Workbook(file_path).Použití get_worksheet() indexem nebo jménem, pak přečtěte hodnoty buněk prostřednictvím value Vlastnictví :

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}")

Krok 3: Uložte do cílového formátu

Workbook.save() Podporuje více formátů prostřednictvím SaveFormat.Použití SaveFormat.CSV pro oddělený výstup a SaveFormat.MARKDOWN Pro tabulky s označením:

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.")

Časté problémy a opravy

ModuleNotFoundError: No module named 'aspose' Instalace balíčku v aktivním virtuálním prostředí: pip install aspose-cells-foss. Potvrdím s pip show aspose-cells-foss.

FileNotFoundError Když si přidáte pracovní knihu Použití pathlib.Path Pro výstavbu přenosných cest: Workbook(str(Path("data") / "file.xlsx")).

Celičtí hodnoty se vrací None Po čtení Bílá buňka je prázdná nebo mimo rozsah. Cell.is_empty() Zkontrolujte před čtením value.

Výstup CSV obsahuje pouze první list save() s SaveFormat.CSV aktivní pracovní list pouze. použijte set_active_worksheet() Vyberte si list, který chcete exportovat před úsporou.

Soubor XLSX není otevřen Excelem Ujistěte se, že projdete SaveFormat.XLSX bez něj je formát vyvrácen z - rozšíření souboru; pokud cesta nemá .xlsx Výstupní prodloužení nemusí být platné.

Často kladené otázky

Potřebuje aspose-cells-foss Microsoft Office?

No. Knihovna čte a píše soubory s rozhraním původně v čistém Pythonu bez jakékoli závislosti na Microsoft Office, COM automatizace nebo Windows API.

Které verze Python jsou podporovány?

Python 3.7 nebo novější. balíček běží na kontejnery Windows, macOS, Linux a Docker.

Je knihovna zdarma pro komerční použití?

Je vydán pod licencí MIT. Můžete jej používat, upravovat a distribuovat pro jakýkoli účel, včetně komerčních aplikací.

Jak se v jednom listu nachází všechna buňka?

Použití Cells.iter_rows() Zpět na řádek podle řádu:

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)

Které formáty můžu uložit?

SaveFormat Podporuje XLSX, CSV, TSV, MARKDOWN,a JSON.Použití SaveFormat.from_extension(file_path) automaticky odhalovat formát z souborového trasy.