Com començar amb Aspose.Cells FOSS per a Python

aspose-cells-foss Python és una biblioteca gratuïta, llicenciada per MIT per a la creació, lectura i el desenvolupament. Convertir arxius de la cartera d’anuncis — no requereix Microsoft Office, no hi ha extensions natives, pur Python de la PIPI.

Guia de pas a pas

Pas 1: Instal·la el paquet

Instal·lació de la PIP amb el PIB:

pip install aspose-cells-foss>=26.3.1

Verifica la instal·lació:

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

Pas 2: Import de les classes necessàries

from aspose.cells_foss import Workbook, SaveFormat

Pas 3: Crear un llibre de treball i escriure dades

Utilitzar Workbook() per crear un nou llibre de treball.Add a workheet with add_worksheet(),Després Accés a la seva xarxa de cèl·lules mitjançant el cells Propietat i ús Cells.cell(row, col) Per aconseguir un Cell.- Esdeveniment de valors amb 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.")

Pas 4: Llegeix el llibre de treball enrere

Carregar un fitxer existent mitjançant el passatge de la ruta de fitxers a Workbook(file_path).Utilitzar get_worksheet() per index o nom, després llegir els valors de la cèl·lula a través del value Propietat de la propietat:

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

Pas 5: Salvar a altres formats

Workbook.save() Suport a diversos formats per mitjà de SaveFormat.Utilitzar SaveFormat.CSV Per a producció separada i SaveFormat.MARKDOWN Per a les taules de marcador:

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

Problemes comuns i fixos

ModuleNotFoundError: No module named 'aspose' Instal·la el paquet en l’entorn virtual actiu: pip install aspose-cells-foss. Confirmant amb pip show aspose-cells-foss.

FileNotFoundError Quan carregar un llibre de treball Utilitzar pathlib.Path Per construir els camins portàtils: Workbook(str(Path("data") / "file.xlsx")).

El valor de la cèl·lula torna None Després de la lectura La cèl·lula és buida o fora de l’àrea. utilitzar Cell.is_empty() Per comprovar abans de llegir value.

La sortida de CSV només conté la primera fila save() amb SaveFormat.CSV Exporta només la taula de treball activa. utilitzar set_active_worksheet() Seleccionar la fulla que vol exportar abans d’estalviar.

El fitxer XNUMX no s’obre per Excel Assegura’t de passar SaveFormat.XLSX sense que el format sigui derivat de la El camí de la ruta; si no hi ha .xlsx L’extensió de la producció pot no ser vàlida.

Preguntes freqüents

¿Les cèl·lules de les instal·lacions requereixen Microsoft Office?

No. La biblioteca llegeix i escriu els arxius de la cartera nativa en Python pur sense cap dependència sobre Microsoft Office, COM automàtica o Windows API.

Quines versions de Python estan supportades?

Python 3.7 o posterior. El paquet s’executa en els contenidors de Windows, macOS, Linux i Docker.

La biblioteca és lliure per a ús comercial?

Sí. Es publica sota la Llicència MIT. Pot utilitzar, modificar i redistribuir-la per a qualsevol propòsit, incloses les aplicacions comercials.

Com es pot iterar sobre totes les cèl·lules d’una fulla?

Utilitzar Cells.iter_rows() Per a la ronda per rècord:

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)

Quins formats puc guardar?

SaveFormat suport XLSX, CSV, TSV, MARKDOWN,i JSON.Utilitzar SaveFormat.from_extension(file_path) per detectar el format automàticament des d’un camí de fitxer.