Referencia de comandos (instrucciones de instalación y configuración a continuación):

# 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

Introducción a PyEnv

La gestión de intérpretes y versiones de diferentes idiomas es una especie de área gris en el mundo Pythonic a partir de septiembre de 2024, pero, por supuesto, la comunidad tiene soluciones "no oficiales" que evitan este problema.
Uno particularmente bueno es PyEnv, que se basa en gran medida en las soluciones de Ruby para la gestión de versiones, algo que Ruby hace muy bien.
PyEnv es básicamente una colección de scripts de shell que ayudan a instalar y seleccionar una versión o intérprete de Python específico, tanto en el ámbito global como localizado.
Funciona insertando un directorio de shims en la RUTA y repetirá el shim de acuerdo con condiciones específicas para mapear el binario de Python (así como otras configuraciones como mapear pip, cambiar el entorno PYTHON_VERSION, etc.).
Esta guía se centrará en MacOS y las distribuciones de Linux de la familia Debian, y cubrirá la configuración tanto en bash como en zsh. No cubrirá pyeenv-win.

Instalación de PyEnv

Mac OS

Esto supone que homebrew y xcode-tools están instalados.
La primera línea instalará dependencias para instalar y compilar versiones de Python.
La segunda línea instalará pyeenv.
La tercera línea es opcional y agregará una carga de pyenv antes de ejecutar Brew para evitar una advertencia falsa positiva al ejecutar Brew Doctor y evitar errores en caso de que esté desarrollando paquetes Brew Python. Tenga en cuenta que se coloca en .zshrc, su Mac ya debería tener zsh habilitado de forma predeterminada a menos que sea una máquina más antigua, en cuyo caso probablemente debería agregarlo a .bash_profile.

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

Linux (basado en Debian)

Primero, instala las dependencias.
Luego, clona el repositorio público en $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 && \
git clone https://github.com/pyenv/pyenv.git $HOME/.pyenv

Postinstalación (tanto MacOS como Linux)

Agregue esto a su archivo de configuración de shell correspondiente, .bash_profile si está usando bash, .zshrc si está usando zsh. Descubra cuál con echo $SHELL si no está seguro.

## pyenv configs
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"

if command -v pyenv 1>/dev/null 2>&1; then
  eval "$(pyenv init -)"
fi

Finalmente, actualiza el entorno de tu terminal para ver los cambios con el ejecutivo "$SHELL".

Después de esta configuración, su Python (¡no python3!) se asignará a su versión de Python configurada con pyenv.
Te recomiendo que luego instales una versión de Python (consulta la referencia de comandos más arriba) y la configures como tu versión global.
Verifique que todo funcionó con python --version para ver si su versión instalada coincide con la que eligió. Si no es así, es probable que todavía esté apuntando a la configuración predeterminada del sistema, por lo que es posible que haya seguido uno de los pasos a continuación (probablemente la parte para actualizar la terminal, cerrar y volver a abrir la ventana de la terminal si no está seguro de qué hacer). ).

¡Diviértete con una gestión de versiones de Python más sensata!