Como verificar a versão do Python: Windows, macOS e Linux

Saber qual versão do Python você está usando é mais importante do que parece. Muitas bibliotecas e frameworks dependem de versões específicas do Python, e o código pode se comportar de maneira diferente entre as versões. Executar scripts em uma versão não suportada ou inesperada geralmente leva a falhas de instalação ou erros de tempo de execução difíceis de diagnosticar.

Neste guia, vou te mostrar maneiras simples e confiáveis de verificar sua versão do Python em sistemas operacionais, ambientes e configurações comuns. Se você está começando a aprender Python, recomendo fazer nosso Introdução ao Python, que aborda habilidades como tipos de dados, listas, funções básicas e pacotes.

Como verificar a versão do Python a partir da linha de comando

A maneira mais comum de verificar a versão do Python é usando o terminal do seu computador (Mac/Linux) ou o Prompt de Comando/PowerShell (Windows).

Usando Python --version

Esse comando pergunta ao sistema qual interpretador Python está associado ao comando python e mostra sua versão.

python --version

Esse comando funciona na maioria dos sistemas se o python estiver configurado corretamente no seu PATH. Mas, o comando pode não funcionar se python apontar para o Python 2 ou não estiver no PATH.

Usando python3 --version

Alguns sistemas, especialmente macOS e Linux, exigem que você use python3 para referenciar explicitamente o Python 3. Isso porque a maioria dos computadores modernos já vem com o Python 2 e o Python 3 instalados.

python3 --version

No Windows, esse comando pode não funcionar a menos que o Python tenha sido instalado com python3 explicitamente adicionado.

Usando Python -V (sintaxe alternativa)

Esse comando é uma versão resumida de python --version.

python -V

O comando gera a mesma saída, mas funciona de forma um pouco diferente em alguns ambientes. Em alguns ambientes mais antigos ou shells específicos, o número da versão pode ser enviado para stderr (erro padrão) em vez de stdout (saída padrão).

Para o olho humano, parece igual na tela, mas pode fazer diferença nos scripts se você estiver tentando “encaminhar” esse texto para outro arquivo ou programa.

Como verificar a versão do Python dentro do Python

Às vezes, você pode querer verificar a versão do Python a partir de um script ou de uma sessão interativa. Isso é útil quando você quer que seu código confirme seu ambiente de execução para ajudar na depuração de problemas em seu script.

Você pode acessar os detalhes da versão importando a biblioteca integrada sys. O código abaixo mostra a string completa da versão Python junto com os detalhes da compilação.

-- Check Python version
import sys
print(sys.version)

Esse método é útil quando você está escrevendo lógica condicional que depende da versão do Python e registrando informações de tempo de execução.

Verificando a versão do Python em ambientes virtuais

Como os ambientes virtuais (venv e conda) são usados para projetos específicos, eles podem usar uma versão do Python diferente da versão padrão do seu sistema. Se você criar um ambiente virtual, ele vem com um interpretador Python específico, e ativar o ambiente muda qual executável Python é usado.

Para confirmar a versão ativa do Python no seu ambiente virtual, primeiro ative-o e, em seguida, execute o seguinte comando:

python --version

Se a versão que aparecer não for a que você esperava, talvez o ambiente tenha sido criado com uma instalação diferente do Python ou não esteja ativado no momento.

Recomendo usar nossa Folha de Referência do Conda quando quiser dar uma olhada em como gerenciar pacotes e trabalhar com o ambiente conda.

Como verificar a versão do Python em diferentes sistemas operacionais

Cada sistema operacional lida com o Python de maneira um pouco diferente. Abaixo está como verificar a versão do Python em cada um:

Janelas

Pra ver qual é a versão do Python no Windows, dá pra usar:

python --version

Ou:

py --version

As desvantagens desse método são que várias instalações do Python podem causar confusão, ou python pode não ser reconhecido devido a uma configuração incorreta do PATH. Além disso, o lançador py pode apontar para uma versão diferente da python, causando falha.

macOS e Linux

Para macOS e Linux, é bom saber que o sistema pode vir com um Python pré-instalado que o sistema operacional usa internamente. Além disso, python pode se referir ao Python 2 ou pode nem existir, enquanto python3 geralmente aponta para a versão Python 3 instalada pelo usuário.

Você pode conferir a versão do Python no macOS ou Linux usando:

python --version

Ou use python3 para evitar usar acidentalmente um Python desatualizado ou gerenciado pelo sistema.

python3 --version

Problemas comuns ao verificar a versão do Python

Ao verificar a versão do Python, você pode ficar meio confuso, principalmente quando tem várias ferramentas e ambientes envolvidos:

• “Comando Python não encontrado”: Isso geralmente quer dizer que o Python não está instalado ou não foi adicionado ao PATH do seu sistema. Em alguns sistemas, só está disponível python3, e não python.

• Várias versões do Python instaladas: É normal ter mais de uma versão do Python na mesma máquina. Comandos diferentes, como python, python3 e py, podem apontar para interpretadores diferentes, o que pode fazer com que as verificações de versão pareçam inconsistentes.

• O comando retorna uma versão inesperada: Você pode estar verificando uma instalação do Python diferente daquela que pretendia. Isso geralmente rola quando um ambiente virtual não tá ativado ou quando a ordem do PATH prioriza outro executável Python.

• Incompatibilidade entre IDE e versão do terminal: Seu IDE, como o VS Code ou o PyCharm, pode estar configurado para usar um interpretador Python diferente do seu terminal. O código executado dentro do IDE usa o seu interpretador configurado e pode não ser necessariamente o mesmo que aparece quando você digita " python --version " na sua linha de comando.

Melhores práticas para gerenciar versões do Python

Pra evitar surpresas relacionadas à versão, recomendo usar a lista de verificação abaixo:

• Sempre dá uma olhada na versão do Python antes de instalar as dependências: Sempre execute python --version antes de usar um comando como pip install. Isso garante que você não instale bibliotecas na versão errada sem querer.

• Seja bem claro com os comandos: Se você sabe que precisa do Python 3, use python3 em vez de achar que python vai te levar pra versão certa.

• Use ambientes virtuais de forma consistente: Use um ambiente virtual (venv) para cada novo projeto. Isso mantém a versão e as bibliotecas do seu projeto isoladas do resto do sistema para garantir que cada uma use a versão correta do Python e as dependências certas.

• Evite depender do Python do sistema para projetos: O Python gerenciado pelo sistema é frequentemente usado pelo sistema operacional e não deve ser alterado. Sempre instale sua própria versão do Python para seus projetos para obter os resultados desejados.

Conclusão

Deixar claro qual versão do Python você está usando ajuda a evitar problemas comuns de configuração, reduz a confusão e economiza tempo ao instalar pacotes ou depurar erros.

Pra entender bem o Python, dá uma olhada no nosso Fundamentos de Dados Python e Fundamentos de Programação Python. Por fim, eu recomendo nosso carreira de desenvolvedor Python para aprender sobre testes de código e controle de versão em web scraping e desenvolvimento de pacotes.