Jak załadować arkusz kalkulacyjny w Python

Ten przewodnik pokazuje, jak załadować pliki arkuszy kalkulacyjnych XLSX i CSV w Python przy użyciu Workbook, uzyskać dostęp do arkuszy za pomocą get_worksheet() oraz odczytać wartości komórek poprzez siatkę Worksheet.cells. Biblioteka działa w czystym Python bez Microsoft Office ani natywnych rozszerzeń.

Przewodnik krok po kroku

pip install aspose-cells-foss

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

from aspose.cells_foss import Workbook

from aspose.cells_foss import Workbook

wb = Workbook("report.xlsx")
print("Loaded:", wb.file_path)

from aspose.cells_foss import Workbook

wb = Workbook("report.xlsx")

# By index
ws = wb.get_worksheet(0)

# By name
ws_named = wb.get_worksheet("Summary")

print(f"Worksheets: {len(wb.worksheets)}")
print(f"First sheet: {ws.name}")

from aspose.cells_foss import Workbook

wb = Workbook("report.xlsx")
ws = wb.get_worksheet(0)
cells = ws.cells

# Read individual cells
product = cells.cell(0, 0).value   # row 0, col 0 (A1)
revenue = cells.cell(0, 1).value   # row 0, col 1 (B1)

print(f"Product: {product}")
print(f"Revenue: {revenue}")

# Safe read with empty check
cell = cells.cell(1, 0)
if not cell.is_empty():
    print(f"A2: {cell.value}")

from aspose.cells_foss import Workbook

wb = Workbook("report.xlsx")
ws = wb.get_worksheet(0)

for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
    print(row)

Typowe problemy i rozwiązania

FileNotFoundError podczas ładowania Sprawdź, czy ścieżka jest prawidłowa i plik istnieje. Użyj pathlib.Path do przenośnych ścieżek: Workbook(str(Path("data") / "report.xlsx")).

Cell.value returns None Komórka jest pusta lub poza zakresem. Użyj Cell.is_empty() aby sprawdzić przed odczytem value. Współrzędne poza zakresem nie generują błędów — zwracają puste komórki.

Plik zabezpieczony hasłem generuje błąd Przekaż hasło jako drugi argument: Workbook("protected.xlsx", "secret").

Ładuje się tylko pierwszy arkusz podczas odczytu pliku CSV Pliki CSV zawierają pojedynczy arkusz. Użyj Workbook.load_csv(file_path) na istniejącym Workbook instancji, jeśli musisz zaimportować dane CSV do określonej pozycji arkusza, zamiast odczytywać przez Workbook() konstruktor bezpośrednio.

Nie znaleziono nazwy arkusza przy użyciu get_worksheet(name) Nazwy arkuszy są rozróżniane pod względem wielkości liter. Wypisz ws.name dla każdego indeksu w wb.worksheets aby potwierdzić dokładną nazwę przed wywołaniem get_worksheet("Name").

Najczęściej zadawane pytania

Czy to działa na Linuksie i macOS?

Tak. aspose-cells-foss jest czystym Python i działa na Windows, macOS, Linux oraz w kontenerach Docker bez żadnych natywnych rozszerzeń ani zależności systemowych.

Jakie formaty plików mogę wczytać?

Konstruktor Workbook() obsługuje pliki XLSX. Pliki CSV można wczytać, przekazując ścieżkę .csv lub wywołując Workbook.load_csv(file_path) na instancji Workbook.

Jak znaleźć ostatni wiersz zawierający dane?

Iteruj przy użyciu Cells.iter_rows() i zatrzymaj się, gdy wszystkie wartości w wierszu są None, lub użyj Cell.is_empty() na komórkach granicznych, aby wykryć, gdzie kończą się dane.

Czy mogę otworzyć skoroszyt bez znajomości jego formatu z góry?

Przekaż ścieżkę pliku do Workbook(file_path). Biblioteka wywnioskuje format z rozszerzenia pliku i nagłówków pliku. Jeśli rozszerzenie jest brakujące lub niejednoznaczne, użyj jawnej opcji formatu zapisu/odczytu.

Jak odczytać komórkę po jej literowym adresie, takim jak „B3”?

Używaj zerowo-indeksowanych liczb całkowitych dla wierszy i kolumn: B3 to wiersz 2, kolumna 1. Konwertuj literowe adresy przy pomocy ord(col_letter) - ord("A") dla jednopismennych kolumn. Na przykład, B to ord("B") - ord("A") == 1, więc cells.cell(2, 1) odpowiada B3.

Zobacz także

• Jak rozpocząć pracę z Aspose.Cells FOSS for Python
• Jak zapisać arkusze kalkulacyjne w Python
• Jak wczytać arkusze kalkulacyjne w Python
• Dokumentacja wprowadzająca
• API Reference
• Aspose.Cells for Python — Enterprise Knowledge Base