Comment télécharger un disque dans Python
Ce guide montre comment charger les fichiers de fichier XLSX et CSV dans Python en utilisant Workbook,Accès à des feuilles de travail avec get_worksheet(),et lire les valeurs cellulaires à travers le Worksheet.cells La bibliothèque fonctionne en Python pur sans Microsoft Office ou des extensions autochtones.
Guide étape par étapes
Étape 1 : Installer le package
Installez le package Aspose.Cells FOSS de PyPI en utilisant la commande pip ci-dessous :
pip install aspose-cells-foss>=26.3.1Vérifier l’installation en important Workbook et envoyez un message de confirmation :
from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")Étape 2 : Importation des classes requises
Importation de la Workbook Classes de aspose.cells_foss Pour accéder à la feuille de recharge API :
from aspose.cells_foss import WorkbookÉtape 3 : Télécharger un livre de travail d’un fichier
Passez le fil de route à Workbook() Pour charger un fichier existant. Le constructeur accepte une option password Pour les fichiers protégés :
from aspose.cells_foss import Workbook
wb = Workbook("report.xlsx")
print("Loaded:", wb.file_path)Étape 4 : Accéder à un tableau de travail
Utiliser get_worksheet() avec un index intégral (0 basé) ou la barre de nom de feuille. Utilisez le worksheets Propriété pour voir combien de feuilles le livre contient :
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}")Étape 5 : Lire les valeurs cellulaires
Les cellules d’accès à travers le Worksheet.cells Propriété : Utilisation Cells.cell(row, col) à Récupérer A Cell par sa ligne et ses coordonnées de colonne basées sur zéro. Lire les données avec Le Cell.value Propriété : Utilisation Cell.is_empty() Pour éviter les cellules blanches en toute sécurité :
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}")Étape 6 : Télécharger toutes les roues
Utiliser Cells.iter_rows() Pour passer par toutes les lignes sans connaître la dimension. Passage values_only=True Pour obtenir des valeurs Python claires au lieu de Cell Les objets :
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)Problèmes communs et fixations
FileNotFoundError Quand le chargement Vérifiez que le chemin est correct et que l’archive existe. pathlib.Path pour portable Les sentiers : Workbook(str(Path("data") / "report.xlsx")).
Cell.value Retourner None La cellule est vide ou hors de gamme.Utilisez Cell.is_empty() Vérifier avant de lire value.Les coordonnées hors-range ne font pas de erreurs – ils retournent les cellules vides.
Le fichier protégé par mot de passe provoque un erreur Passez le mot de passe comme deuxième argument : Workbook("protected.xlsx", "secret").
Seul le premier fichier se charge lors de la lecture d’un CSV Les fichiers CSV contiennent une seule feuille.Utilisez Workbook.load_csv(file_path) sur une existante Workbook par exemple si vous devez importer les données CSV dans une position de feuille spécifique Au lieu de lire par la Workbook() Le constructeur en direct.
Nom de la page n’a pas été trouvé avec get_worksheet(name) Les noms de feuilles sont sensibles au cas. ws.name Pour chaque index, il est wb.worksheets à Confirmez le nom avant de vous appeler get_worksheet("Name").
Questions fréquemment posées
Est-ce que ça fonctionne sur Linux et macOS ?
Oui oui. aspose-cells-foss Python est pure et fonctionne sur Windows, macOS, Linux et Docker. Contenteurs sans extensions ou dépendances du système.
Quels formats de fichier puis-je télécharger ?
Le Workbook() le constructeur soutient les fichiers XLSX. Les ficher CSV peuvent être chargés en passant un .csv En chemin ou en appelant Workbook.load_csv(file_path) sur A Workbook et instance.
Comment puis-je trouver la dernière ligne de données ?
Il s’agit avec Cells.iter_rows() et s’arrêter lorsque toutes les valeurs en conséquence sont None,ou Utiliser Cell.is_empty() sur les cellules frontalières pour détecter où se terminent les données.
Puis-je ouvrir un livre de travail sans connaître le format d’avance ?
Passez le chemin de fichier à Workbook(file_path).La bibliothèque présente le format de l’extension de fichier et les heads de fichiers. si l’extansion est manquante ou ambigu, utilisez un Option de format explicite Save/Lad.
Comment lire une cellule par son adresse lettre comme “B3”?
Utilisez la ligne basée sur zéro et les intégrations de colonne : B3 est la barre 2, col 1. avec ord(col_letter) - ord("A") pour les columnes de texte unique. par exemple, B est ord("B") - ord("A") == 1,Et ainsi cells.cell(2, 1) Les cartes à B3.