Quando você começa a aprender a programar em Python, uma das primeiras coisas que chama atenção é a indentação. Talvez você já tenha ouvido alguém dizer que Python é diferente por causa disso. Mas, afinal, o que é indentação no Python? Por que ela é tão importante? E como você deve usá-la para evitar erros no seu código?
Neste artigo, vamos explicar tudo isso com uma linguagem fácil e exemplos simples. Mesmo quem nunca programou antes vai entender o que é indentação no Python e como ela funciona.
Para começar, que tal ver na prática? O vídeo abaixo explica de forma rápida e clara o que é a indentação e por que ela é fundamental em Python. Dê o play!
Canal: Dev Aprender | Jhonatan de Souza
O que é indentação?
Indentação é o espaço vazio no começo de uma linha de código. Em Python, esses espaços servem para indicar que um grupo de comandos está junto, formando um bloco.
Se você escrever um programa em Python, não basta só digitar os comandos um abaixo do outro. Você precisa “empurrar” algumas linhas para a direita usando espaços ou a tecla Tab. Esse empurrão é a indentação.
Imagine que você está escrevendo uma lista de tarefas. Se você fizer assim:
Fazer compras
Lavar roupa
Estudar Python
Está tudo no mesmo nível, certo? Mas se você quiser mostrar que “Estudar Python” tem etapas, você pode escrever assim:
Estudar Python
Assistir vídeo
Praticar código
Fazer exercícios
Aqui, as tarefas depois de “Estudar Python” estão um pouco deslocadas para a direita, mostrando que são partes dessa tarefa.
No Python, a indentação funciona do mesmo jeito para organizar o código.
Por que a indentação é importante em Python?
Diferente de outras linguagens, Python usa a indentação para entender o que pertence a cada parte do código.
Em linguagens como C, Java ou JavaScript, usamos símbolos como {} para agrupar comandos. No Python, o espaço em branco (a indentação) substitui esses símbolos.
Isso significa que:
- A indentação define o começo e o fim de blocos de código.
- Um bloco de código é um grupo de comandos que funcionam juntos.
- Se você errar a indentação, o Python não vai entender seu código e vai dar erro.
Por isso, a indentação é fundamental para o funcionamento correto dos seus programas em Python.
Exemplos práticos de indentação em Python
Vamos ver exemplos simples para entender melhor.
Exemplo 1: Estrutura condicional (if)
idade = 18
if idade >= 18:
print("Você é maior de idade")
print("Pode tirar a carteira de motorista")
print("Fim do programa")Explicação:
- As duas linhas depois do
ifestão indentadas, ou seja, têm espaços à frente. - Isso indica que elas fazem parte do bloco do
if. - A última linha não está indentada, então ela não faz parte do bloco.
Saída:
Você é maior de idade
Pode tirar a carteira de motorista
Fim do programa
Se a variável idade fosse menor que 18, o Python não executaria as linhas indentadas.
Exemplo 2: Laço de repetição (for)
for i in range(3):
print("Número:", i)
print("Repetindo o código")
print("Fim do loop")Aqui, as duas linhas com print estão dentro do laço porque têm indentação. O print fora do laço não está indentado.
Como usar a indentação corretamente?
Regras básicas de indentação em Python
- Use quatro espaços para cada nível de indentação.
- Nunca misture espaços e tabulações (tecla Tab). Escolha um e mantenha para todo o arquivo.
- Todas as linhas dentro de um bloco precisam ter a mesma quantidade de espaços.
Por exemplo:
if True:
print("Correto") # 4 espaços
print("Também correto")Errado:
if True:
print("2 espaços")
print("4 espaços") # misturou espaços, erro!O que acontece se a indentação estiver errada?
Se a indentação não estiver correta, o Python mostra um erro chamado IndentationError.
Exemplo:
if True:
print("Erro de indentação")Mensagem de erro:
IndentationError: expected an indented block
Isso acontece porque o Python esperava que a linha dentro do if estivesse indentada
Diferença entre espaços e tabs (tabulações)
Existem duas formas principais de criar indentação no teclado:
- Espaços: apertar a barra de espaço várias vezes.
- Tab: tecla que insere uma tabulação (um espaço maior).
No Python, o recomendado é usar sempre quatro espaços por nível de indentação.
Misturar tab e espaço pode causar erros difíceis de entender. Por isso, configure seu editor de texto para usar espaços ao pressionar Tab.
Exemplos de blocos de código com indentação
Vamos ver como a indentação organiza blocos de código.
Bloco if-else
numero = 5
if numero > 0:
print("Número positivo")
else:
print("Número zero ou negativo")Aqui, temos dois blocos:
- O bloco do
if(linha indentada depois doif) - O bloco do
else(linha indentada depois doelse)
Bloco com função
def saudacao():
print("Olá, seja bem-vindo!")
print("Vamos aprender Python!")
saudacao()As duas linhas dentro da função são indentadas para mostrar que pertencem à função.
Dicas para aprender a usar indentação no Python
- Pratique bastante escrevendo códigos simples.
- Use um editor de código que destaque a indentação, como PyCharm, VSCode ou Thonny.
- Sempre formate seu código para ter quatro espaços por nível.
- Leia mensagens de erro de indentação com calma para entender o problema.
- Lembre-se: a indentação é parte da sintaxe do Python, não é apenas um detalhe visual.
Indentação em estruturas mais complexas
À medida que você avança, vai ver que a indentação ajuda a organizar o código mesmo quando ele fica grande e complexo.
Exemplo com loops e funções
def verificar_numeros():
for i in range(1, 6):
if i % 2 == 0:
print(i, "é par")
else:
print(i, "é ímpar")
verificar_numeros()Aqui temos:
- Função indentada
- Laço indentado dentro da função
- Condicional indentada dentro do laço
Cada nível tem sua indentação para deixar claro quem está dentro de quem.
Indentação e legibilidade do código
A indentação também deixa seu código mais fácil de ler. Quando o código está bem indentado, você consegue entender melhor o que ele faz.
Se o código não tiver indentação, fica confuso e difícil de manter.
Pense na indentação como a organização de um texto ou de um parágrafo. Ela ajuda o leitor a entender as partes importantes e a relação entre elas.
Comparação: código Python com e sem indentação correta
| Código correto (com indentação) | Código incorreto (sem indentação) |
|---|---|
| if True: | if True: |
| print(“Oi”) | print(“Oi”) |
| else: | else: |
| print(“Tchau”) | print(“Tchau”) |
O Python do lado esquerdo entende o código, mas o da direita gera erro.
Palavras-chave relacionadas à indentação em Python
- Bloco de código: conjunto de linhas que funcionam juntas.
- Nível de indentação: quantidade de espaços no começo da linha.
- IndentationError: erro que aparece quando a indentação está errada.
- Tabulação (Tab): tecla usada para criar indentação.
- Espaços: alternativa à tabulação para criar indentação.
Como configurar seu editor para evitar erros de indentação
Os editores modernos ajudam muito:
- Configure para usar 4 espaços ao apertar Tab.
- Habilite a visualização de espaços e tabs.
- Use autoformatadores, que arrumam a indentação para você.
- Alguns exemplos de editores que ajudam:
Indentação em outras linguagens: o que torna Python diferente?
A maioria das linguagens usa símbolos para indicar blocos:
{}no C, Java e JavaScript.begineendno Pascal.
Python dispensa esses símbolos e usa só a indentação para marcar blocos.
Essa escolha torna o código mais limpo e fácil de ler, mas exige atenção à indentação.
Resumo: os principais pontos sobre indentação no Python
- Indentação é o espaço no começo da linha de código.
- Ela indica blocos e a estrutura do programa.
- Python usa a indentação para entender o código, não símbolos.
- Use 4 espaços por nível de indentação, nunca misture espaços e tabs.
- Erros de indentação causam IndentationError.
- Boa indentação facilita a leitura e manutenção do código.
- Configure seu editor para ajudar a manter a indentação correta.
Conclusão
A indentação no Python não é apenas uma questão de organização visual. Ela é parte essencial da linguagem e determina como seu código será interpretado.
Aprender a usar a indentação corretamente é o primeiro passo para escrever programas em Python sem erros e que funcionam bem.
Se você seguir as regras e praticar, vai perceber que a indentação deixa o código mais bonito, claro e fácil de entender — tanto para você quanto para outras pessoas.
Agora que você já sabe o que é indentação no Python, comece a praticar! Experimente escrever pequenos programas e preste atenção na indentação para evitar erros.
Boa sorte na sua jornada na programação com Python!
