Aspose.Cells FOSS
Python
Guia del desenvolupador
Features

Exportació de format de full de càlcul per a Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() la crida gestiona la cadena completa de sortida — XLSX, CSV, TSV, Markdown o JSON — conservant els valors i les fórmules de les cel·les sense requerir Microsoft Office.

Instal·lació i configuració 

pip install aspose-cells-foss

Importa les classes principals:

from aspose.cells_foss import Workbook, SaveFormat, Cell
from aspose.cells_foss import MarkdownHandler, MarkdownSaveOptions
from aspose.cells_foss import CSVSaveOptions

Formats de sortida compatibles

FormatConstant SaveFormatNotes
XLSXSaveFormat.XLSXFormat per defecte; conserva estils, fórmules, gràfics
CSVSaveFormat.CSVSeparat per comes; només el primer full per defecte
TSVSaveFormat.TSVValors separats per tabuladors
MarkdownSaveFormat.MARKDOWNGenera taules Markdown estàndard
JSONSaveFormat.JSONRepresentació JSON estructurada de les dades del full

Important: Aspose.Cells FOSS fa no no admet l’exportació a PDF, HTML, PNG, TIFF, DOCX o PPTX. Aquests només estan disponibles en el comercial aspose-cells-python paquet només.

Exemples d’ús

Desa a XLSX

El format predeterminat en desar amb una .xlsx extensió:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750

workbook.save("report.xlsx")

Desa a CSV 

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save("data.csv", SaveFormat.CSV)

Desa a Markdown

Exporta dades tabulars com a taules Markdown — útil per a documentació i generació de README:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "First name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save_as_markdown("data.md")

La sortida és una taula Markdown estàndard:

| First name | Age |
|---|---|
| Alice | 30 |
| Bob | 25 |

Markdown amb opcions

Utilitzeu MarkdownSaveOptions per a un control detallat:

from aspose.cells_foss import Workbook, Cell, MarkdownSaveOptions

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "City"
ws.cells["B1"].value = "Population"
ws.cells["A2"].value = "London"
ws.cells["B2"].value = 9000000

options = MarkdownSaveOptions()

workbook.save_as_markdown("cities.md", options)

Markdown a cadena (en memòria)

Genera una cadena Markdown sense escriure al disc:

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Key"
ws.cells["B1"].value = "Value"
ws.cells["A2"].value = "version"
ws.cells["B2"].value = "26.3.0"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)

Desa a JSON

Exporta les dades del llibre de treball com a JSON estructurat per a canals d’API:

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95.5
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88.0

workbook.save("data.json", SaveFormat.JSON)

Carrega un CSV i desa com a XLSX 

from aspose.cells_foss import Workbook, SaveFormat

workbook = Workbook()
workbook.load_csv("input.csv")
workbook.save("output.xlsx", SaveFormat.XLSX)

Consells i bones pràctiques

Exportació Markdown

  • Utilitzeu MarkdownHandler.save_markdown_to_string(wb) per a casos d’ús en memòria com ara respostes d’API.

Exportació CSV

  • L’exportació CSV escriu per defecte el primer full de treball.
  • Els caràcters especials (comes, salts de línia) en els valors de les cel·les s’entenquen automàticament.

Exportació JSON

  • L’exportació JSON utilitza les adreces de les cel·les com a claus. Adequada per a intercanvi de dades; les fórmules complexes s’emmagatzemen com a expressions de cadena.

Problemes comuns i resolucions

IncidènciaResolució
ModuleNotFoundError: No module named 'aspose.cells_foss'Executa pip install aspose-cells-foss i confirma que l’entorn virtual està actiu
AttributeError a SaveFormat.PDFL’exportació PDF no es troba a la biblioteca FOSS; utilitza SaveFormat.MARKDOWN o SaveFormat.XLSX en lloc
Sortida Markdown buidaAssegura’t que almenys una cel·la del full té un valor abans de desar
Problemes de codificació al MarkdownUtilitza MarkdownHandler.save_markdown_to_string() per a la sortida de cadena en memòria amb control total de la codificació

Preguntes freqüents

Quins formats de sortida admet Aspose.Cells FOSS? XLSX, CSV, TSV, Markdown i JSON.

Puc convertir a PDF? No. L’exportació a PDF requereix el comercial aspose-cells-python paquet. Aspose.Cells FOSS exporta només a XLSX, CSV, TSV, Markdown i JSON.

Puc carregar un XLSX existent i tornar-lo a desar com a Markdown? Sí. Workbook("existing.xlsx") carrega el fitxer i workbook.save_as_markdown("output.md") l’exporta.

És compatible la sortida de Markdown basada en flux? Sí. Utilitza MarkdownHandler.save_markdown_to_string(workbook) per obtenir el Markdown com una cadena Python sense cap operació d’E/S de fitxers.

Quines versions de Python són compatibles? Python 3.7 i posteriors.

Vegeu també

 Català