Como verificar a versão do Python no seu sistema

O Python é muito usado em automação, criação de scripts e desenvolvimento de aplicações. Muitas ferramentas e scripts exigem uma versão específica do Python para funcionar corretamente. Com a versão errada, problemas podem aparecer. Por isso, verificar a versão do Python no sistema antes de rodar scripts ou ferramentas é importante: evita problemas de compatibilidade e mantém a automação confiável.

Este guia mostra várias formas de verificar a versão do Python no sistema, incluindo métodos pela linha de comando, por ambiente virtual e dentro de scripts.

📌 Estratégias de implementação recomendadas:

Clique para escolher um método	💻 Melhor para usuários individuais	💻💻💻 Melhor para empresas
Método 1: verificar a versão do Python pela linha de comando	✓	✓
Método 2: verificar a versão do Python no interpretador	✓
Método 3: identificar todas as versões do Python instaladas no sistema		✓
Método 4: verificar a versão do Python dentro de um ambiente virtual	✓	✓
Método 5: verificar a versão do Python em um script ou aplicação	✓	✓

Formas de verificar a versão do Python no sistema

Este guia apresenta cinco formas de verificar a versão do Python no sistema. Antes de começar, confira os requisitos abaixo.

📌 Pré-requisitos gerais:

• acesso à linha de comando ou ao terminal do sistema
• Python instalado no sistema
• permissões adequadas para executar comandos
• saber se o sistema usa aliases de execução ou ambientes virtuais

Método 1: verificar a versão do Python pela linha de comando

A linha de comando é a forma mais rápida de confirmar a versão do Python. Neste método, você verifica o interpretador que o sistema executa por padrão, conforme a configuração atual do PATH.

Passos:

1. Abra a linha de comando.
   • Windows: pressione Win + R para abrir a caixa Executar, digite cmd e pressione Enter para abrir o Prompt de Comando.
   • MacOS: pressione Command + Space para abrir o Spotlight, digite Terminal e pressione Return.
   • Linux: pressione Ctrl + Alt + T ou abra o menu de aplicativos, procure por Terminal e abra-o.
2. Execute o comando a seguir:

python --version

3. Se o comando não retornar Python 3, execute:

python3 --version

4. Analise a saída para identificar a versão do Python instalada. Ela deve aparecer assim:

Python 3.11.7

📌 Observação: este método mostra a versão do Python vinculada ao PATH atual do sistema. Se houver várias versões instaladas, o sistema executa o interpretador que aparece primeiro na ordem do PATH.

Método 2: verificar a versão do Python no interpretador

Outra forma confiável é verificar a versão dentro do próprio Python. Esse método roda a verificação em uma sessão ativa do interpretador e traz informações mais detalhadas, incluindo dados de build e do compilador.

Passos:

1. Abra a linha de comando.
   • Windows: pressione Win + R para abrir a caixa Executar, digite cmd e pressione Enter para abrir o Prompt de Comando.
   • MacOS: pressione Command + Space para abrir o Spotlight, digite Terminal e pressione Return.
   • Linux: pressione Ctrl + Alt + T ou abra o menu de aplicativos, procure por Terminal e abra-o.
2. Inicie o interpretador do Python executando:

python

ou, se necessário:

python3

3. No prompt do Python (>>>), digite:

import sys
print(sys.version)

4. Analise a saída para confirmar a versão do Python e os detalhes da build.
5. Saia do interpretador:

exit()

💡Também é possível pressionar Ctrl + D no macOS/Linux ou Ctrl + Z e depois Enter no Windows.

📌 Observação: este método mostra a versão usada pela sessão ativa do interpretador. O resultado pode ser diferente de outras versões do Python instaladas no sistema.

Método 3: identificar todas as versões do Python instaladas no sistema

Se o sistema tem várias instalações do Python, este método ajuda a identificá-las. Ele lista todos os interpretadores acessíveis pela linha de comando. Use quando precisar resolver conflitos de versão ou confirmar quais versões do Python estão disponíveis para os projetos.

Passos:

1. Abra a linha de comando.
   • Windows: pressione Win + R para abrir a caixa Executar, digite cmd e pressione Enter para abrir o Prompt de Comando.
   • MacOS: pressione Command + Space para abrir o Spotlight, digite Terminal e pressione Return.
   • Linux: pressione Ctrl + Alt + T ou abra o menu de aplicativos, procure por Terminal e abra-o.
2. No Windows, execute:

where python

Esse comando lista todos os caminhos onde existe python.exe.

3. No macOS ou Linux, execute:

which -a python
which -a python3

Esse comando mostra todos os caminhos em que há binários do Python.

4. Analise a lista de executáveis do Python e seus caminhos de arquivo.

📌 Observação: este método lista os executáveis do Python resolvidos pelo PATH do sistema. Ele não mostra instalações que não estão acessíveis pela linha de comando.

Método 4: verificar a versão do Python dentro de um ambiente virtual

Ambientes virtuais isolam dependências e versões do Python por projeto. Ao usar um ambiente virtual, verifique a versão do Python depois da ativação. Assim, você confirma que o projeto roda no interpretador pretendido, e não no padrão do sistema.

Passos:

1. Ative o ambiente virtual.
   • Windows (Prompt de Comando):

.\.venv\Scripts\activate

• • Windows (PowerShell):

.\.venv\Scripts\Activate.ps1

• • macOS/Linux:

source .venv/bin/activate

2. Com o ambiente ativo, verifique a versão do Python executando:

python --version

3. Analise a saída para confirmar a versão do Python atribuída ao ambiente virtual.
4. Desative o ambiente ao terminar:

deactivate

Método 5: verificar a versão do Python em um script ou aplicação

Às vezes é preciso confirmar a versão do Python enquanto um script ou aplicação está em execução. Essa abordagem funciona bem em fluxos automatizados, pipelines de CI/CD e scripts que dependem de recursos específicos do Python. Use para verificar o interpretador em tempo de execução antes que o código rode uma lógica crítica.

Passos:

1. Adicione as linhas a seguir ao script Python:

import sys
print(sys.version_info)

2. Execute o script pelo método pretendido (linha de comando, agendador, pipeline ou runtime de uma aplicação).
3. Analise a saída para confirmar a versão do Python usada durante a execução.

Considerações adicionais

Tenha estes pontos em mente para evitar confusão e obter resultados precisos ao verificar versões do Python.

Aliases de execução no Windows

No Windows, os aliases de execução podem redirecionar o comando python para a versão da Microsoft Store em vez do interpretador instalado. Isso leva a resultados inesperados na hora de verificar a versão do Python.

Você gerencia os aliases de execução em Configurações > Aplicativos > Aliases de execução de aplicativo ou usa o Python launcher (py --version) para confirmar qual interpretador roda.

Coexistência de Python 2 e Python 3

Alguns sistemas têm Python 2 e Python 3 instalados ao mesmo tempo. Nesses casos, o comando python pode apontar para o Python 2, enquanto python3 aponta para o Python 3.

Ambientes virtuais

Ambientes virtuais isolam versões do Python por projeto. A versão dentro de um ambiente virtual pode ser diferente da instalação global.

💡 Ative o ambiente antes de verificar a versão do Python para não obter resultados enganosos.

Ordem do PATH

O PATH do sistema controla qual executável do Python roda por padrão. Com várias versões instaladas, a primeira entrada do PATH tem prioridade.

Ferramentas que exigem python3

Algumas ferramentas chamam python3 explicitamente, mesmo quando python existe. Isso evita ambiguidade e garante acesso aos recursos da linguagem no Python 3.

Solução de problemas

Se tiver dificuldades ao verificar versões do Python, veja os problemas comuns abaixo e siga as ações sugeridas.

Comando python não encontrado

O Python pode não estar instalado ou o sistema pode não conseguir localizá-lo. Instale o Python pelo python.org ou pelo gerenciador de pacotes. Depois da instalação, verifique se o diretório de instalação foi adicionado ao PATH do sistema.

Versão informada incorreta

Se a versão informada não for a esperada, os aliases de execução do Windows ou a ordem do PATH podem estar redirecionando o comando python. Confira as configurações de alias de execução para saber qual interpretador aparece primeiro no PATH.

O script falha sem motivo aparente

Quando um script falha sem causa clara, a versão ativa do Python pode não atender aos requisitos dele. Garanta que o script rode com o interpretador pretendido e que a versão exigida esteja ativa em tempo de execução.

Divergência no ambiente virtual

Se as verificações retornam o Python do sistema em vez da versão do projeto, o ambiente virtual pode não estar ativo. Ative o ambiente antes de rodar verificações ou scripts e confirme que o prompt de comando reflete o ambiente ativo.

Várias versões gerando confusão

Padronize as versões do Python por projeto ou ambiente. Use python3 em projetos modernos e considere ferramentas como pyenv no macOS/Linux ou o Python launcher py no Windows.

Escolha o método certo para verificar a versão do Python com precisão

Verificar a versão do Python no sistema é um passo simples, mas não deve ser deixado de lado. Ele influencia diretamente a estabilidade da automação, dos scripts e dos fluxos de desenvolvimento. Dá para verificar a versão do Python de várias formas: pela linha de comando, pelo interpretador ou nos ambientes ativos.

Confirmar rapidamente qual versão do Python está instalada e em execução reduz erros e ajuda a manter os sistemas consistentes entre usuários e dispositivos.

Temas relacionados:

• Como restringir o acesso ao Python no Microsoft Excel usando o PowerShell
• O que são aliases de execução de aplicativo e como gerenciá-los no Windows
• Biblioteca de scripts do NinjaOne