Leitura de pastas de trabalho
Abra e leia arquivos do Excel
Leitura de pastas de trabalho é uma aula grátis de Python Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Python Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Python Academy inclui 4 aulas no total.
Excel a partir de Python
openpyxl é a biblioteca padrão para ler e gravar arquivos modernos do Excel (no formato .xlsx). Ela permite que o Python automatize tarefas de planilhas que, de outra forma, as pessoas fariam manualmente.
Esta lição se concentra em abrir arquivos e ler seu conteúdo.
O modelo de pasta de trabalho
Os arquivos do Excel têm uma hierarquia clara que o openpyxl reproduz:
- Pasta de trabalho o arquivo inteiro
- Planilha uma aba dentro dela
- Célula uma única caixa no estilo A1 com um valor
Você navega da pasta de trabalho para a planilha e, depois, para a célula.
Abrindo um arquivo
load_workbook('data.xlsx') lê um arquivo e retorna uma pasta de trabalho. Para arquivos grandes que você apenas lê, passe read_only=True para transmitir as linhas e economizar memória.
Use data_only=True para ler o último resultado calculado das células com fórmulas, em vez do texto da fórmula.
Selecionando uma planilha
wb.active fornece a planilha atualmente selecionada. wb['Sheet1'] seleciona pelo nome, e wb.sheetnames lista todas as abas. Escolher a planilha correta é o primeiro passo de qualquer leitura.
sheetnames = ['Summary', 'Q1', 'Q2', 'Q3']
wanted = 'Q2'
if wanted in sheetnames:
print('Selecting sheet:', wanted)
else:
print('Not found, defaulting to', sheetnames[0])Lendo uma única célula
Acesse uma célula pelo endereço do Excel: ws['A1'].value ou por números com ws.cell(row=1, column=1).value. O atributo .value contém os dados reais, que podem ser texto, um número, uma data ou None.
Letras e números de colunas
As colunas do Excel são letras (A, B, ... Z, AA), mas o openpyxl também usa números começando em 1. Às vezes é necessário fazer a conversão entre eles. Veja aqui o número da coluna a partir de uma letra.
def col_to_num(letters):
num = 0
for ch in letters.upper():
num = num * 26 + (ord(ch) - ord('A') + 1)
return num
for c in ['A', 'B', 'Z', 'AA']:
print(c, '->', col_to_num(c))Percorrendo as linhas
ws.iter_rows(values_only=True) fornece cada linha como uma tupla de valores. Esta é a maneira mais simples de ler uma tabela. A primeira linha geralmente é o cabeçalho.
Você percorre as linhas como faria com qualquer iterável.
rows = [
('Name', 'Age', 'City'),
('Ada', 36, 'London'),
('Linus', 54, 'Helsinki'),
]
header = rows[0]
for record in rows[1:]:
print(dict(zip(header, record)))Encontrando o intervalo utilizado
ws.max_row e ws.max_column informam até onde os dados se estendem. ws.dimensions retorna o texto do intervalo, como 'A1:C10'. Use esses recursos para evitar a leitura de células vazias.
Lendo um intervalo
Você pode obter uma fatia de uma planilha: ws['A1:C3'] retorna uma tupla de tuplas de linhas contendo objetos de célula. Isso é útil quando você precisa apenas de parte de uma planilha, em vez de todas as linhas.
Lidando com células vazias
Células vazias retornam None. Planilhas reais são desorganizadas, portanto proteja-se contra valores ausentes durante a leitura, por exemplo, substituindo-os por um valor padrão. Isso evita falhas nas etapas seguintes.
raw_row = ('Ada', None, 'London')
clean = [v if v is not None else 'N/A' for v in raw_row]
print(clean)Lendo várias planilhas
Uma pasta de trabalho pode dividir os dados entre várias abas, por exemplo, uma por mês. Percorra wb.sheetnames, selecione cada planilha e leia-a usando a mesma lógica. Marque cada linha com o nome da planilha para acompanhar sua origem.
Esse padrão consolida muitas abas em um único conjunto de dados combinado.
Verificação rápida
Teste suas habilidades de leitura.
Recapitulação
Agora você sabe ler arquivos do Excel:
- Hierarquia: pasta de trabalho > planilha > célula
load_workbookcom as opçõesread_onlyedata_only- Selecione planilhas por meio de
wb.active,wb['Name']ewb.sheetnames - Leia com
.valueeiter_rows(values_only=True), e verifiquemax_row/max_column - Proteja-se contra
Noneem células vazias
Perguntas Frequentes
A aula “Leitura de pastas de trabalho” é grátis?
Sim — o texto completo de “Leitura de pastas de trabalho” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Python Academy, atualize para CoddyKit PRO. O curso de Python Academy inclui 4 aulas no total.
O que vou aprender em “Leitura de pastas de trabalho”?
Abra e leia arquivos do Excel Você pratica Python Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Python Academy?
Nenhuma experiência prévia é necessária. Python Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Leitura de pastas de trabalho”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Python Academy?
Sim. Cada aula de Python Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Leitura de pastas de trabalho
- Escrita e estilização de células
- Fórmulas e gráficos
- Processamento em lote de relatórios