Cómo comenzar con Aspose.Cells FOSS para Python

aspose-cells-foss Python es una biblioteca gratuita y licenciada por MIT para crear, leer y Convertir archivos de hoja de espalda — no se requiere Microsoft Office, no hay exteniones nativas, pura Python de la PYPI.

Guía paso a paso

Paso 1: Instalar el paquete

Instalar desde PyPI con pip:

pip install aspose-cells-foss>=26.3.1

Verifique la instalación:

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

Paso 2: Importar las clases necesarias

from aspose.cells_foss import Workbook, SaveFormat

Paso 3: Crea un libro de trabajo y escriba datos

Uso Workbook() para crear un nuevo libro de trabajo.Añadir una hoja de obra con add_worksheet(),Y luego acceso a su red celular a través de la cells Propiedad y uso Cells.cell(row, col) Para obtener una Cell.-Considerar valores con 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.")

Paso 4: Leer el libro de trabajo de vuelta

Cargar un archivo existente al pasar el camino de archivos a Workbook(file_path).Uso de get_worksheet() por índice o nombre, luego leer los valores de la célula a través del value Propiedad de la propiedad:

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

Paso 5: Salva en otros formatos

Workbook.save() soporta varios formatos a través de SaveFormat.Uso de SaveFormat.CSV Para de la producción separada y SaveFormat.MARKDOWN Para las tablas de marcado:

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

Problemas y soluciones comunes

ModuleNotFoundError: No module named 'aspose' Instalar el paquete en el entorno virtual activo: pip install aspose-cells-foss. Confirmando con pip show aspose-cells-foss.

FileNotFoundError Cuando se carga un libro de trabajo Uso pathlib.Path Para construir caminos portátiles: Workbook(str(Path("data") / "file.xlsx")).

El valor celular regresa None Después de la lectura La célula está vacía o fuera de alcance. Cell.is_empty() Para comprobar antes de leer value.

La salida de CSV contiene sólo la primera hoja save() con SaveFormat.CSV Exporta solo la hoja de trabajo activa.Utilizar set_active_worksheet() Seleccione la hoja que desea exportar antes de ahorrar.

El archivo XLSX no se abre por Excel. Asegúrese de pasar SaveFormat.XLSX sin él, el formato se deriva de la El camino de la ruta; si no hay .xlsx La extensión de la producción puede no ser válida.

Preguntas frecuentes

¿Es necesario que el aspose-cells-foss Microsoft Office?

No. La biblioteca lee y escribe los archivos de hoja nativa en Python puro sin depender de Microsoft Office, COM automation o Windows APIs.

¿Qué versiones de Python se apoyan?

Python 3.7 o más tarde. el paquete se ejecuta en los contenedores de Windows, macOS, Linux y Docker.

¿La biblioteca es libre para uso comercial?

Se publica bajo la Licencia MIT. Puede utilizar, modificar y redistribuirlo para cualquier propósito, incluidas las aplicaciones comerciales.

¿Cómo puedo iterar sobre todas las células en una hoja?

Uso Cells.iter_rows() para iterar la línea por la siguiente:

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)

¿Qué formatos puedo guardar?

SaveFormat Apoyo XLSX, CSV, TSV, MARKDOWN,y, JSON.Uso de SaveFormat.from_extension(file_path) para detectar el formato automáticamente desde un camino de archivo.