Como executar um script Python (terminal, IDE ou arquivo)

Três formas de rodar Python, e quando usar cada uma

Antes de escrever qualquer coisa séria, vale conhecer os três lugares onde o código Python de fato roda. Cada um serve para uma situação, e confundir eles é fonte comum de dor de cabeça no primeiro dia.

As três opções são:

1. O shell interativo — um prompt ao vivo onde cada linha roda enquanto você digita.
2. Um arquivo .py salvo, executado pelo terminal — o jeito padrão de rodar qualquer coisa não trivial.
3. O botão "run" do editor — um atalho para a opção 2 quando você estiver no VS Code, PyCharm ou parecido.

Vamos passar por cada um e depois falar de quando escolher qual.

O shell interativo (ótimo para fuçar)

Abra um terminal e digite:

python3

Vai aparecer um prompt parecido com >>>. Cada linha que você digitar roda na hora. Isso é perfeito para testar one-liners, lembrar o que uma função faz ou experimentar uma expressão pequena sem criar um arquivo inteiro:

>>> 2 + 2
4
>>> name = "Ada"
>>> f"Hello, {name}"
'Hello, Ada'

Quando terminar, digite exit() ou aperte Ctrl-D.

O shell é um rascunho. É ótimo para explorar, mas não salva nada. Fechou a janela, o trabalho sumiu. Por isso, assim que você quer guardar o código, muda para um arquivo.

Rodando um arquivo .py salvo

É assim que 99% do Python de fato roda — num arquivo, pelo terminal. Os passos são sempre os mesmos:

1. Crie um arquivo de texto simples com extensão .py. O nome é com você; hello.py funciona.
2. Escreva um pouco de Python dentro.
3. Abra um terminal na pasta que contém o arquivo.
4. Rode python3 hello.py.

Aqui está o script mínimo possível. Salve isso num arquivo chamado hello.py:

Depois, no seu terminal:

python3 hello.py

Você deve ver três linhas de saída. Pronto — é esse o fluxo todo. Todo tutorial, todo deploy em produção, todo cron job, toda pipeline de dados é alguma versão de "rode um arquivo .py".

Algumas coisas que vale entender sobre esse comando:

• python3 é o interpretador. No Windows, geralmente é só python.
• hello.py é um caminho relativo à sua pasta atual. Se estiver na pasta errada, vai ver No such file or directory — confira onde o terminal está com pwd (macOS/Linux) ou cd (Windows) e vá para o lugar certo.
• Python roda o arquivo uma vez, de cima para baixo, e sai. Não deixa nada rodando depois.

Rodando por um editor

Assim que seus arquivos passam de algumas linhas, um editor facilita a vida. As duas opções mais comuns:

• VS Code, com a extensão oficial do Python. Aperte o botão Run no canto superior direito, ou F5.
• PyCharm, que tem o próprio sistema de Run configurations.

As duas opções fazem exatamente o que você acabou de fazer na mão — chamam python3 seu_arquivo.py por baixo dos panos, num painel de terminal embutido no editor. Não tem mágica. Quando algo dá errado, você sempre pode voltar a rodar o arquivo direto pelo terminal.

Um hábito útil: mesmo usando o botão run do editor, olhe o comando que ele mostra. Se disser algo como /opt/homebrew/bin/python3.12 hello.py, isso te diz exatamente qual interpretador Python foi usado. Problemas confusos de interpretador (em que pip install parece funcionar mas import não acha a biblioteca) são quase sempre causados por dois Pythons diferentes na mesma máquina.

Passando entrada para o seu script

Um script nem sempre é uma coisa de uma só vez. Muitas vezes você quer dar entrada enquanto ele está rodando. A forma mais simples é com input():

Quando você roda isso num terminal de verdade, ele espera você digitar algo e apertar enter. Você também pode rodar esse snippet aqui no navegador — o runtime embutido cuida do prompt para você.

Quando os scripts não terminam

A maioria dos scripts roda uma vez e sai. Alguns rodam para sempre — um servidor web, por exemplo, ou um bot que fica olhando uma pasta esperando arquivos novos. Se você escreveu um loop infinito sem querer e seu terminal parece travado, é isso que está acontecendo: seu script ainda está rodando. Aperte Ctrl-C para parar. Essa combinação é seu botão de reset para tudo que travar.

Escolha suas ferramentas e depois esqueça delas

Tudo mais nestes docs assume que você consegue rodar um snippet — seja colando num arquivo e rodando python3 arquivo.py, seja usando o editor embutido na página. Qual ferramenta você usa é com você, e a resposta certa muda várias vezes ao longo de uma carreira. Comece simples: um editor de texto comum e um terminal são um setup perfeitamente bom para as próximas semanas.

Na sequência: as regras com que o Python realmente se importa — indentação, quebras de linha e a sintaxe mínima que você precisa saber antes que qualquer outra coisa faça sentido.