Python es uno de los lenguajes más versátiles en programación moderna. Si trabajas en múltiples proyectos, seguramente necesitas gestionar diferentes versiones. Para eso está pyenv: una herramienta liviana que te permite instalar y usar varias versiones de Python fácilmente.
Table of Contents
Open Table of Contents
🔧 ¿Qué necesitas?
- Ubuntu 18.04+ o WSL en Windows 10/11
- Conexión a internet
- Acceso a
sudo
1. Instala dependencias necesarias
sudo apt update && sudo apt install -y \
git curl wget make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev llvm libncurses5-dev \
libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev \
ca-certificates
2. Instala pyenv
git clone https://github.com/pyenv/pyenv.git ~/.pyenv
3. Configura tu entorno
Agrega estas líneas a ~/.bashrc
, ~/.zshrc
, ~/.profile
o ~/.zprofile
, según tu shell:
# Configuración de pyenv
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
Luego ejecuta:
exec "$SHELL"
4. Verifica versiones disponibles
pyenv install --list
Deberías ver una lista de versiones de Python disponibles para instalar.
5. Instala y activa una versión de Python
Ejemplo:
pyenv install 3.13.5
pyenv global 3.13.5
Verifica con:
python --version
Deberías ver algo como:
Python 3.13.5
🛠️ ¿Problemas comunes?
Pyenv no se reconoce
Verifica que hayas agregado correctamente las líneas a tu archivo de entorno (.zprofile
, .bashrc
, etc.).
Error con OpenSSL
Instala el paquete necesario:
echo "deb http://security.ubuntu.com/ubuntu impish-security main" | sudo tee /etc/apt/sources.list.d/impish-security.list
sudo apt update && sudo apt install libssl1.1
🔄 Actualiza pyenv
cd ~/.pyenv && git pull
🚀 Conclusión
Ya tienes Python configurado correctamente con pyenv. Ahora puedes:
✅ Instalar múltiples versiones ✅ Alternar entre proyectos ✅ Usar entornos virtuales con facilidad