Jak zacząć z Aspose.Cells FOSS dla Pythona
aspose-cells-foss Python to darmowa biblioteka licencjonowana przez MIT do tworzenia, czytania i Konwertowanie plików tarczy – nie wymagane Microsoft Office, nie ma native rozszerzenia, czysty Python z PIPI.
Przewodnik krok po kroku
Krok 1: Instalacja pakietu
Instalacja z PIPP:
pip install aspose-cells-foss>=26.3.1Sprawdź instalację:
from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")Krok 2: Import wymaganych klas
from aspose.cells_foss import Workbook, SaveFormatKrok 3: Tworzenie księgi roboczej i pisanie danych
Używanie Workbook() do tworzenia nowej książki. dodać arkusz roboczy z add_worksheet(),Wtedy dostęp do sieci komórkowej za pośrednictwem cells Własność i wykorzystanie Cells.cell(row, col) Aby uzyskać A Cell.Zestaw wartości z 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: Przeczytaj książkę z powrotem
Pobierz istniejący plik poprzez przejście przez ścieżkę pliku do Workbook(file_path).• Używanie get_worksheet() według nazwy lub indeksów, a następnie czytaj wartości komórkowe za pośrednictwem value Właściwości :
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 5: Zapisz do innych formatów
Workbook.save() obsługuje wiele formatów poprzez SaveFormat.• Używanie SaveFormat.CSV Dla wydajność oddzielona i SaveFormat.MARKDOWN Dla tabeli Markdown:
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.")Wspólne problemy i rozwiązania
ModuleNotFoundError: No module named 'aspose' Instalacja pakietu w aktywnym środowisku wirtualnym: pip install aspose-cells-foss. Potwierdź z pip show aspose-cells-foss.
FileNotFoundError Kiedy ładujesz książkę roboczą Używanie pathlib.Path W celu budowania przenośnych dróg: Workbook(str(Path("data") / "file.xlsx")).
Wróć wartość komórki None Po przeczytaniu komórka jest pusta lub poza zakresem. użyj Cell.is_empty() Sprawdź przed czytaniem value.
Wytwórnia CSV zawiera tylko pierwszą kartę save() z SaveFormat.CSV Wywożysz tylko aktywny arkusz roboczy. użyj set_active_worksheet() Wybierz kartę, którą chcesz eksportować przed oszczędzaniem.
Plik XLSX nie jest otwarty przez Excel Upewnij się, że przejdziesz SaveFormat.XLSX Bez niego format jest wyciągnięty z rozszerzenie pliku; jeśli droga nie ma .xlsx Rozszerzenie produkcji może nie być ważne.
Często zadawane pytania
Czy aspose-cells-foss wymaga Microsoft Office?
Biblioteka czyta i pisze pliki z płytki w czystym Pythonie bez uzależnienia od Microsoft Office, automatyzacji COM lub API systemu Windows.
Jakie wersje Python są obsługiwane?
Python 3.7 lub później. pakiet działa na kontenerach Windows, macOS, Linux i Docker.
Czy biblioteka jest wolna do użytku komercyjnego?
Jest on wydany na podstawie licencji MIT. Możesz używać, modyfikować i redistribuować go do jakiegokolwiek celu, w tym aplikacji komercyjnych.
Jak mam iterować wszystkie komórki w jednym arkuszu?
Używanie Cells.iter_rows() Wystarczy zarejestrować się w kolejce:
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)Jakie formaty mogę zapisać?
SaveFormat Wsparcie XLSX, CSV, TSV, MARKDOWN,i JSON.• Używanie SaveFormat.from_extension(file_path) Aby automatycznie wykryć format z drogi pliku.
