Referência de comando (instruções de instalação e configuração abaixo):

# List all versions of python interpreters available to install:
pyenv install -l
# List all versions of CPython (the default interpreter) available to install:
pyenv install -l | grep -E '^\s*[0-9]'
# Install specified version. In this case it installs 3.12.6
pyenv install 3.12.6
# List versions installed locally:
pyenv versions
# See global version
pyenv global
# Set global version to x.x.x; in this case it sets to 3.12.6
pyenv global 3.12.6
# See local version
pyenv local
# Set global version to x.x.x; in this case it sets to 2.7.18
pyenv global 3.12.6

Introdução ao PyEnv

O gerenciamento de diferentes versões de idiomas e intérpretes é uma espécie de área cinzenta no mundo Pythonic em setembro de 2024, mas é claro que a comunidade tem soluções "não oficiais" que contornam esse problema.
Um deles em particular é o PyEnv, que se baseia muito nas soluções do Ruby para gerenciamento de versões, algo que o Ruby faz muito bem.
PyEnv é basicamente uma coleção de scripts de shell que ajudam a instalar e selecionar uma versão ou interpretador específico do python, em escopos globais e localizados.
Ele funciona inserindo um diretório de shims no PATH e irá refazer o shim de acordo com condições específicas para mapear o binário python (bem como outras configurações, como mapeamento de pip, troca de ambiente PYTHON_VERSION, etc). Este guia se concentrará no MacOS e nas distros Linux da família Debian e cobrirá a configuração no bash e no zsh. Não cobrirá pyenv-win.

Instalando PyEnv

Mac OS

Isso pressupõe que o homebrew e o xcode-tools estejam instalados.

A primeira linha instalará dependências para instalar e construir versões python.
A segunda linha instalará o próprio pyenv.
A terceira linha é opcional e anexará um carregamento pyenv antes de executar o brew para evitar um aviso de falso positivo ao executar o brew doctor e para evitar erros caso você esteja desenvolvendo pacotes brew python. Observe que ele está sendo colocado em .zshrc, seu Mac já deve ter o zsh habilitado por padrão, a menos que seja uma máquina mais antiga; nesse caso, você provavelmente deve anexá-lo a .bash_profile.

brew install openssl readline sqlite3 xz zlib tcl-tk && \ preparar instalar pyenv \ && echo "alias brew='env PATH=\"${PATH//$(pyenv root)\/shims:/}\" brew'" >> ~/.zshrc

brew install openssl readline sqlite3 xz zlib tcl-tk && \
brew install pyenv \
&& echo "alias brew='env PATH=\"${PATH//$(pyenv root)\/shims:/}\" brew'" >> ~/.zshrc

Linux (baseado em Debian)

Primeiro, instale as dependências.

Em seguida, clone o repositório público em $HOME/.pyenv.

sudo apt update && sudo apt install build-essential \ libssl-dev zlib1g-dev \ libbz2-dev libreadline-dev libsqlite3-dev curl git\ libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev && \ clone do git https://github.com/pyenv/pyenv.git $HOME/.pyenv

brew install openssl readline sqlite3 xz zlib tcl-tk && \
brew install pyenv \
&& echo "alias brew='env PATH=\"${PATH//$(pyenv root)\/shims:/}\" brew'" >> ~/.zshrc

Pós-instalação (MacOS e Linux)

Adicione isto ao seu arquivo de configuração de shell relevante, .bash_profile se você estiver usando bash, .zshrc se estiver usando zsh. Descubra qual com echo $SHELL se não tiver certeza.

## configurações pyenv exportar PYENV_ROOT="$HOME/.pyenv" exportar PATH="$PYENV_ROOT/bin:$PATH" if comando -v pyenv 1>/dev/null 2>&1; então avaliação "$(pyenv inicialização -)" fi

brew install openssl readline sqlite3 xz zlib tcl-tk && \
brew install pyenv \
&& echo "alias brew='env PATH=\"${PATH//$(pyenv root)\/shims:/}\" brew'" >> ~/.zshrc

Finalmente, atualize seu ambiente de terminal para ver as alterações com exec "$SHELL".

Após esta configuração, seu python (não python3!) será mapeado para sua versão python configurada com pyenv.

Eu recomendo que você instale uma versão python (veja a referência de comando acima) e configure-a como sua versão global.
Verifique se tudo funcionou com python --version para ver se a versão instalada corresponde à que você escolheu. Caso contrário, provavelmente ainda está apontando para o padrão do sistema, então você pode ter cometido uma das etapas abaixo (provavelmente a parte para atualizar o terminal, fechar e reabrir a janela do terminal se não tiver certeza do que fazer ).

Divirta-se com um gerenciamento de versão python mais saudável!