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.1Verificaț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 WorkbookPasul 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-fosseste 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.