Como carregar uma planilha em Python

Este guia mostra como carregar arquivos de planilha XLSX e CSV em Python usando Workbook, folhas de trabalho com acesso a: get_worksheet(), e ler os valores das células através do sistema de Worksheet.cells A biblioteca funciona em Python puro sem Microsoft Office ou extensões nativas.

Guia passo a passo

pip install aspose-cells-foss>=26.3.1

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)

Problemas comuns e soluções

FileNotFoundError quando a carga é efectuada. Verifique se o caminho é correto e que o arquivo existe. Use pathlib.Path para aparelhos portáteis trajetórias: Workbook(str(Path("data") / "report.xlsx")).

Cell.value Renda de rendimentos None A célula está vazia ou fora de alcance. Cell.is_empty() para verificar antes de ler. value.Coordenadas fora de gama não geram erros devolvem células vazias.

Arquivo protegido por senha apresenta um erro Passe a senha como segundo argumento: Workbook("protected.xlsx", "secret").

Apenas a primeira folha é carregada quando se lê um CSV. Os ficheiros CSV contêm uma única folha. Utilize Workbook.load_csv(file_path) sobre uma situação existente. Workbook exemplo, se precisar de importar dados CSV para uma posição específica da folha. Em vez de ler o texto, a Comissão Workbook() diretamente ao construtor.

Nome da folha não encontrado com get_worksheet(name) Os nomes das folhas são sensíveis a maiúsculas. Imprimir ws.name para cada índice em: wb.worksheets a) para o Confirme o nome exato antes de ligar. get_worksheet("Name").

Perguntas Frequentes

Isto funciona no Linux e MacOS?

• Sim, é verdade. aspose-cells-foss é Python puro e funciona em Windows, macOS, Linux e Docker. Containers sem extensões nativas ou dependências de sistema.

Que formatos de arquivo posso carregar?

A Comissão Workbook() O constructor suporta arquivos XLSX. Os arquivos CSV podem ser carregados passando um .csv caminho ou por telefone Workbook.load_csv(file_path) em um Workbook - Por exemplo.

Como eu encontro a última linha com dados?

Iterar com: Cells.iter_rows() e parar quando todos os valores em uma linha são: None, ou uso de Cell.is_empty() nas células de fronteira para detectar onde os dados terminam.

Posso abrir um livro de trabalho sem saber o seu formato antecipadamente?

Passe o caminho do arquivo para: Workbook(file_path).A biblioteca deduz o formato a partir de: Se a extensão estiver ausente ou ambígua, use um código de identificação. Opção explícita de formato salvamento/carregamento.

Como é que leio uma célula pelo endereço da carta, como “B3”?

Usar números inteiros de linha e coluna baseados em zero: B3 é a linha 2, colina 1. Converte endereços de letras com: ord(col_letter) - ord("A") para colunas de uma única letra, por exemplo:, B é: ord("B") - ord("A") == 1,Então … cells.cell(2, 1) mapas para B3.

Ver também:

• Como começar com Aspose.Cells FOSS para Python
• Como salvar planilhas em Python
• Como carregar planilhas em Python
• Começar Docs
• Referência API
• Aspose.Cells for Python — Enterprise Knowledge Base