Aspose.Cells FOSS
Python
Przewodnik programisty
Features

Eksport formatu arkusza kalkulacyjnego dla Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() wywołanie obsługuje pełny potok wyjściowy — XLSX, CSV, TSV, Markdown lub JSON — zachowując wartości komórek i formuły bez konieczności posiadania Microsoft Office.

Instalacja i konfiguracja 

pip install aspose-cells-foss

Importuj podstawowe klasy:

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

Obsługiwane formaty wyjściowe

FormatStała SaveFormatUwagi
XLSXSaveFormat.XLSXDomyślny format; zachowuje style, formuły, wykresy
CSVSaveFormat.CSVRozdzielany przecinkami; domyślnie tylko pierwszy arkusz
TSVSaveFormat.TSVWartości rozdzielane tabulacjami
MarkdownSaveFormat.MARKDOWNGeneruje standardowe tabele Markdown
JSONSaveFormat.JSONStrukturalna reprezentacja JSON danych arkusza

Ważne: Aspose.Cells FOSS robi nie obsługi eksportu do PDF, HTML, PNG, TIFF, DOCX lub PPTX. Są one dostępne wyłącznie w wersji komercyjnej aspose-cells-python tylko w pakiecie.

Przykłady użycia

Zapisz jako XLSX

Domyślny format przy zapisywaniu z .xlsx rozszerzeniem:

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

Zapisz jako 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)

Zapisz jako Markdown

Eksportuj dane tabelaryczne jako tabele Markdown — przydatne do dokumentacji i generowania plików 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")

Wyjściem jest standardowa tabela Markdown:

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

Markdown z opcjami

Użyj MarkdownSaveOptions do precyzyjnej kontroli:

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 do ciągu znaków (w pamięci)

Wygeneruj ciąg Markdown bez zapisywania na dysk:

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)

Zapisz jako JSON

Eksportuj dane skoroszytu jako ustrukturyzowany JSON dla potoków 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)

Wczytaj CSV i zapisz jako XLSX 

from aspose.cells_foss import Workbook, SaveFormat

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

Wskazówki i najlepsze praktyki

Eksport Markdown

  • Użyj MarkdownHandler.save_markdown_to_string(wb) do przypadków użycia w pamięci, takich jak odpowiedzi API.

Eksport CSV

  • Eksport CSV zapisuje domyślnie pierwszy arkusz.
  • Specjalne znaki (przecinki, nowe linie) w wartościach komórek są automatycznie cytowane.

Eksport JSON

  • Eksport JSON używa adresów komórek jako kluczy. Odpowiedni do wymiany danych; złożone formuły są przechowywane jako ich wyrażenia w formie łańcucha znaków.

Typowe problemy i rozwiązania

ProblemRozdzielczość
ModuleNotFoundError: No module named 'aspose.cells_foss'Uruchom pip install aspose-cells-foss i potwierdź, że wirtualne środowisko jest aktywne
AttributeError włączone SaveFormat.PDFEksport PDF nie jest dostępny w bibliotece FOSS; użyj SaveFormat.MARKDOWN lub SaveFormat.XLSX zamiast
Pusty wynik MarkdownUpewnij się, że przynajmniej jedna komórka w arkuszu ma wartość przed zapisem
Problemy z kodowaniem w MarkdownUżyj MarkdownHandler.save_markdown_to_string() do wyjścia łańcucha w pamięci z pełną kontrolą kodowania

Najczęściej zadawane pytania

Jakie formaty wyjściowe obsługuje Aspose.Cells FOSS? XLSX, CSV, TSV, Markdown i JSON.

Czy mogę przekonwertować do PDF? Nie. Eksport do PDF wymaga wersji komercyjnej aspose-cells-python pakiet. Aspose.Cells FOSS eksportuje wyłącznie do XLSX, CSV, TSV, Markdown i JSON.

Czy mogę wczytać istniejący plik XLSX i ponownie zapisać go jako Markdown? Tak. Workbook("existing.xlsx") wczytuje plik i workbook.save_as_markdown("output.md") eksportuje go.

Czy obsługiwane jest strumieniowe wyjście Markdown? Tak. Użyj MarkdownHandler.save_markdown_to_string(workbook) aby uzyskać Markdown jako ciąg Python bez żadnego odczytu/zapisu plików.

Jakie wersje Python są obsługiwane? Python 3.7 i nowsze.

Zobacz także

 Polski