Cum să încărcați o foaie de calcul în Python

Cum să încărcați o foaie de calcul în Python

Acest ghid arată cum să încărcați fișiere de calcul XLSX și CSV în Python folosind Workbook, fișele de lucru cu acces la get_worksheet(), şi citesc valorile celulelor prin intermediul Worksheet.cells Biblioteca rulează în Python pur, fără Microsoft Office sau extensii native.

Ghid pas cu pas

Pasul 1: Instalați pachetul

Instalați pachetul Aspose.Font FOSS din PyPI folosind comanda pip de mai jos:

pip install aspose-cells-foss>=26.3.1

Verificați instalația prin importarea: Workbook și imprimarea unui mesaj de confirmare:

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

Pasul 2: Importarea clasei necesare

Importul de Workbook clasa de la aspose.cells_foss pentru a accesa API-ul de încărcare al fișei de calcul:

from aspose.cells_foss import Workbook

Pasul 3: Încărcarea unei cărţi de lucru dintr-un fişier

Treci stringa de calea fişierului la: Workbook() pentru a încărca o foaie de calcul existentă. Constructorul acceptă o opțiune: password argument pentru fișierele protejate:

from aspose.cells_foss import Workbook

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

Pasul 4: Accesați o foaie de lucru

Utilizare: get_worksheet() cu un indice întreag (0-based) sau șirul de nume al fișei. Foloseşte-l. worksheets proprietatea de a vedea câte foi conține cartea de lucru:

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

Pasul 5: Citeste valorile celulelor

Celulele de acces prin intermediul Worksheet.cells proprietate. utilizare Cells.cell(row, col) la … în retrieve a Cell citeste datele cu în cazul Cell.value proprietate. utilizare Cell.is_empty() pentru a trece cu siguranță de celulele goale:

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

Pasul 6: Iterarea tuturor rândurilor

Utilizare: Cells.iter_rows() Să treci prin toate rândurile fără să cunoşti dimensiunile. Pasă de trecere. values_only=True să primească valori Python simple în loc de Cell obiecte:

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)

Probleme comune şi soluţii

FileNotFoundError la încărcare Verificați că calea este corectă și fișierul există. Utilizați pathlib.Path pentru portabile traseele: Workbook(str(Path("data") / "report.xlsx")).

Cell.value rambursări None Celularul este gol sau nu poate fi accesat. Cell.is_empty() să verifici înainte de a citi. value.Coordonatele din afara intervalului nu generează erori ele returnează celule goale.

Fişier protejat cu parolă are o eroare. Treci parola ca al doilea argument: Workbook("protected.xlsx", "secret").

Numai prima foaie se încarcă atunci când se citește un CSV. Fișierele CSV conțin o singură foaie. Utilizați Workbook.load_csv(file_path) pe o bază existentă de Workbook de exemplu, dacă trebuie să importați date CSV într-o poziție specifică a fișei mai degrabă decât citirea prin intermediul Workbook() constructor direct.

Numele fișei nu a fost găsit cu get_worksheet(name) Numele fișelor sunt sensibile la case. Imprimare ws.name pentru fiecare indice din wb.worksheets la … în Confirmă numele exact înainte de a suna. get_worksheet("Name").

Întrebări frecvente

Lucrează pe Linux şi macOS?

  • Da, am fost. aspose-cells-foss este Python pur și rulează pe Windows, macOS, Linux și Docker. containere fără extensii native sau dependențe de sistem.

Ce formate de fişiere pot încărca?

În ceea ce priveşte Workbook() constructor suportă fișiere XLSX. Fișe CSV pot fi încărcate prin trecerea unui .csv drum sau prin apel Workbook.load_csv(file_path) pe o Workbook În cazul în care.

Cum găsesc ultimul rând cu date?

Iterate cu: Cells.iter_rows() și opri atunci când toate valorile într-o linie sunt None, sau utilizare Cell.is_empty() pe celulele de graniță pentru a detecta unde se termină datele.

Pot deschide un caiet de lucru fără să-i cunosc formatul în prealabil?

Treci calea fişierului la: Workbook(file_path).Biblioteca deduce formatul de la Dacă extensiunea lipsește sau este ambiguă, folosiți un cod de identificare. opțiunea explicită format de salvare/încărcare.

Cum citesc o celulă după adresa scrisorii, cum ar fi “B3”?

Utilizați rânduri și coloane bazate pe zero: B3 este linia 2, coloana 1. Convertează adresele literelor cu: ord(col_letter) - ord("A") pentru coloanele cu o singură literă. De exemplu:, B este: ord("B") - ord("A") == 1,Deci … cells.cell(2, 1) hărţi către B3.

Vezi și:

 Română