1. IronXL for Python
  2. Tutoriais
  3. Tutorial em Python para ler arquivos Excel

Como ler arquivos do Excel em Python com IronXL

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Este guia fornece aos desenvolvedores Python instruções passo a passo sobre como utilizar a biblioteca IronXL para ler e editar documentos do Microsoft Excel.

IronXL é uma biblioteca abrangente para processamento de arquivos Excel que suporta várias linguagens de programação, incluindo .NET e Python . Este tutorial foca-se especificamente na utilização do IronXL em scripts Python para ler e editar documentos do Microsoft Excel.

Para um tutorial separado sobre como ler e editar documentos do Microsoft Excel em aplicativos .NET , consulte o seguinte link .

Ler e criar arquivos Excel em Python é fácil usando a biblioteca de Iron SoftwareXL for Python.

Visão geral

Como ler um arquivo Excel em Python

  1. Baixe a biblioteca Python para ler arquivos Excel.
  2. Carregar e ler um arquivo Excel (pasta de trabalho)
  3. Crie uma planilha do Excel em formato CSV ou XLSX.
  4. Editar valores de células em um intervalo de células
  5. Validar os dados da planilha
  6. Exportar dados usando o Entity Framework

Tutorial

Passo 1: Adicione o IronXL como uma dependência em seu projeto Python.

Para integrar a biblioteca IronXL ao seu projeto Python, você deve instalá-la como uma dependência usando o gerenciador de pacotes Python amplamente utilizado, o pip . Abra o terminal e execute o seguinte comando:

pip install IronXL

Isso instalará a versão especificada do IronXL em seu projeto, tornando-a acessível para importação.

ObserveIronXL for Python depende da biblioteca IronXL for .NET . Portanto, é necessário ter o SDK do .NET 6.0 instalado em sua máquina para usar o IronXL for Python.

Etapa 2: Carregar uma planilha do Excel

A classe WorkBook representa uma planilha de Excel. Para abrir um arquivo Excel, usamos o método WorkBook.Load, especificando o caminho do arquivo Excel.

:path=/static-assets/excel-python/content-code-examples/tutorials/how-to-read-excel-file-csharp-1.py
# Load existing spreadsheet
workbook = WorkBook.Load("Spreadsheets\\GDP.xlsx")
PYTHON

Cada WorkBook pode ter múltiplos objetos WorkSheet. Cada um representa uma única planilha do Excel no documento do Excel. Use o método WorkBook.get_worksheet para obter uma referência a uma planilha de Excel específica.

:path=/static-assets/excel-python/content-code-examples/tutorials/how-to-read-excel-file-csharp-2.py
# Assuming workBook is an existing instance of WorkBook
workSheet = workBook.GetWorkSheet("GDPByCountry")
PYTHON

Criando novos documentos do Excel

Para criar um novo documento Excel, construa um novo objeto WorkBook com um tipo de arquivo válido.

:path=/static-assets/excel-python/content-code-examples/tutorials/how-to-read-excel-file-csharp-3.py
# Create a new WorkBook with the specified Excel file format
workBook = WorkBook(ExcelFileFormat.XLSX)
PYTHON

Nota: Use ExcelFileFormat.XLS para suportar versões legadas do Microsoft Excel (95 e anteriores).

Adicionar uma planilha a um documento do Excel

Como explicado anteriormente, um WorkBook do IronXL for Python contém uma coleção de um ou mais WorkSheets.

Esta é a aparência de uma pasta de trabalho com duas planilhas no Excel.

Esta é a aparência de uma pasta de trabalho com duas planilhas no Excel.

Para criar uma nova planilha, chame workbook.create_worksheet com o nome da planilha.

:path=/static-assets/excel-python/content-code-examples/tutorials/how-to-read-excel-file-csharp-4.py
workSheet = workBook.CreateWorkSheet("GDPByCountry")
PYTHON

Acessar valores de células

Ler e editar uma única célula

O acesso aos valores das células individuais da planilha é realizado recuperando a célula desejada de sua WorkSheet como mostrado abaixo:

:path=/static-assets/excel-python/content-code-examples/tutorials/how-to-read-excel-file-csharp-5.py
# Load existing spreadsheet
workbook = WorkBook.Load("test.xlsx")
worksheet = workbook.DefaultWorkSheet

# Access cell B1 in the worksheet
cell = worksheet["B1"]
PYTHON

A classe Cell do IronXL for Python representa uma célula individual em uma planilha Excel. Contém propriedades e métodos que permitem aos usuários acessar e modificar diretamente o valor da célula.

Com uma referência a um objeto Cell, podemos ler e escrever dados em uma célula de planilha.

Ler e escrever um intervalo de valores de células

A classe Range representa uma coleção bidimensional de objetos Cell. Esta coleção se refere a um intervalo literal de células do Excel. Obtenha intervalos usando o indexador de string em um objeto WorkSheet.

:path=/static-assets/excel-python/content-code-examples/tutorials/how-to-read-excel-file-csharp-6.py
# Access cell B1 in the worksheet
cell = workSheet["B1"]

# Read the value of the cell as a string
value = cell.StringValue
print(value)

# Write a new value to the cell
cell.Value = "10.3289"
print(cell.StringValue)
PYTHON

Adicionar fórmula a uma planilha

Defina a fórmula de Cells com a propriedade formula.

:path=/static-assets/excel-python/content-code-examples/tutorials/how-to-read-excel-file-csharp-7.py
# Access range D2:D101 in the worksheet
range_ = workSheet["D2:D101"]
PYTHON

O código abaixo percorre cada célula e define um total percentual na coluna C.

:path=/static-assets/excel-python/content-code-examples/tutorials/how-to-read-excel-file-csharp-8.py
# Iterate through all rows with a value
for y in range(2, i):
    # Get the C cell
    cell = workSheet[f"C{y}"]
    # Set the formula for the Percentage of Total column
    cell.Formula = f"=B{y}/B{i}"
PYTHON

Resumo

IronXl.Excel é uma biblioteca Python independente para leitura de uma ampla variedade de formatos de planilha. Não requer a instalação do Microsoft Excel e não depende do Interop.

Perguntas frequentes

Como faço para ler arquivos do Excel em Python?

Você pode ler arquivos Excel em Python usando o IronXL carregando a planilha com o método WorkBook.Load . Basta fornecer o caminho para o seu arquivo Excel, como workbook = ironxl.WorkBook.load('path/to/workbook.xlsx') .

Posso editar arquivos do Excel em Python sem ter o Excel instalado?

Sim, com o IronXL, você pode editar arquivos do Excel em Python sem precisar ter o Microsoft Excel instalado. Você pode modificar valores de células, adicionar planilhas e aplicar fórmulas diretamente pela biblioteca.

Como posso instalar a biblioteca IronXL for Python?

Para instalar o IronXL for Python, utilize o gerenciador de pacotes pip executando o comando pip install ironxl no seu terminal.

Quais são as vantagens de usar o IronXL para manipulação de arquivos Excel em Python?

O IronXL permite manipular arquivos do Excel sem a necessidade do Microsoft Excel. Ele oferece recursos como leitura, edição, criação de novas planilhas e aplicação de fórmulas, tornando-se uma solução robusta para manipulação de planilhas.

Como posso acessar e modificar uma célula específica em uma planilha do Excel usando o IronXL?

Para acessar uma célula específica em uma planilha do Excel usando o IronXL, use o índice da célula, como em cell = worksheet['A1'] . Você pode ler o valor usando cell.value e modificá-lo atribuindo um novo valor com cell.value = 'New Value' .

É possível trabalhar com intervalos de células no IronXL?

Sim, o IronXL permite trabalhar com intervalos de células usando a classe Range . Você pode acessar um intervalo de células com um indexador de string como range_of_cells = worksheet['B2:E5'] e realizar operações sobre elas.

Como adiciono fórmulas a células do Excel usando IronXL em Python?

Para adicionar fórmulas às células do Excel usando o IronXL, defina a fórmula usando a propriedade formula da célula. Por exemplo, cell.formula = '=A1+B1' soma os valores das células A1 e B1.

O IronXL requer interoperabilidade com o Microsoft Office?

Não, o IronXL não requer o Microsoft Office Interop. Ele opera independentemente do Microsoft Excel, permitindo que você processe arquivos do Excel sem dependências adicionais.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas?
executar um exemplo Veja seus dados se transformarem em uma planilha.