Cómo descargar una hoja de espalda en Python

Este guía muestra cómo cargar los archivos de la hoja de paso XLSX y CSV en Python utilizando Workbook,Acceso a las obras de trabajo con get_worksheet(),y leer los valores de las células a través del Worksheet.cells La biblioteca funciona en Python puro sin Microsoft Office o extensiones nativas.

Guía paso a paso

Paso 1: Instalar el paquete

Instalar el paquete Aspose.Cells FOSS de PyPI utilizando el comando pip a continuación:

pip install aspose-cells-foss>=26.3.1

Verificar la instalación mediante importación Workbook y imprimir un mensaje de confirmación:

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

Paso 2: Importar las clases necesarias

Importar el Workbook clase de aspose.cells_foss Para acceder a la API de carga de la hoja de espalda:

from aspose.cells_foss import Workbook

Paso 3: Cargar un libro de trabajo desde un archivo

Pasar el archivo de ruta en la Workbook() para cargar una hoja de difusión existente. El fabricante acepta una opción opcional. password Los archivos protegidos:

from aspose.cells_foss import Workbook

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

Paso 4: Acceso a una hoja de trabajo

Uso get_worksheet() con un índice integral (0-basado) o la fila de nombre. Utilice el worksheets Propiedad para ver cuántas hojas el libro contiene:

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

Paso 5: Leer los valores de la célula

Los accesos a través de la Worksheet.cells Propiedad y uso Cells.cell(row, col) para Recuperar a Cell por su línea y coordenadas de columna basada en cero. leer los datos con El de Cell.value Propiedad y uso Cell.is_empty() Para eliminar las células blancas de forma segura:

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

Paso 6: Iterate todas las rayas

Uso Cells.iter_rows() Pasar por todas las líneas sin conocer dimensiones. Paso values_only=True para obtener valores de Python claros en lugar de Cell Objetos de:

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)

Problemas y soluciones comunes

FileNotFoundError Cuando cargar Verifique si el camino es correcto y el archivo existe. pathlib.Path Por el portátil Los caminos: Workbook(str(Path("data") / "report.xlsx")).

Cell.value Retorno None La célula está vacía o fuera de alcance. Cell.is_empty() Para comprobar antes de leer value.Las coordenadas de fuera de rango no causan errores, sino que vuelven las células vacías.

El archivo protegido por contraseña provoca un error Pasar la contraseña como segundo argumento: Workbook("protected.xlsx", "secret").

Sólo la primera hoja se carga cuando lee un CSV Los archivos CSV contienen una hoja única. Workbook.load_csv(file_path) En una existente Workbook Por ejemplo, si necesita importar datos de CSV en una posición específica de hoja. En lugar de leer por medio del Workbook() El constructor directamente.

Nombre de la hoja no encontrado con get_worksheet(name) Los nombres de las hojas son sensibles al caso. impresión ws.name Para cada índice de wb.worksheets para Confirmar el nombre antes de llamar get_worksheet("Name").

Preguntas frecuentes

¿Tiene que funcionar en Linux y MacOS?

Sí sí. aspose-cells-foss Python es puro y se ejecuta en Windows, macOS, Linux y Docker. contenedores sin extensiones nativas o dependencias del sistema.

¿Qué formatos de archivo puedo cargar?

El Workbook() el constructor soporta los archivos XLSX. Los archivo CSV se pueden cargar mediante la transferencia de un .csv por el camino o por la llamada Workbook.load_csv(file_path) En el A Workbook de instancia.

¿Cómo puedo encontrar la última línea de datos?

Iterate con Cells.iter_rows() y se detiene cuando todos los valores en una línea son None,o Uso de Cell.is_empty() en las células fronterizas para detectar dónde terminan los datos.

¿Puedo abrir un libro de trabajo sin conocer su formato anticipadamente?

Pasar el camino de archivo a Workbook(file_path).La biblioteca presenta el formato de la extensión de archivo y los heads de fichero. si la extensión está ausente o ambigua, utilice un Opción de formato de almacenamiento/carga.

¿Cómo puedo leer una célula con su dirección de letra como “B3”?

Utilice líneas y integradores de columnas basadas en cero: B3 es línea 2, col 1. con ord(col_letter) - ord("A") para las columnas de letra única. por ejemplo, B Es el ord("B") - ord("A") == 1,Así que cells.cell(2, 1) Mapa de B3.