1. Introducción
Al desarrollar con Python en Ubuntu, es común necesitar diferentes versiones de Python para distintos proyectos. En estos casos, una herramienta de gestión de versiones como pyenv resulta muy útil. En este artículo, explicaremos cómo administrar fácilmente múltiples versiones de Python en Ubuntu usando pyenv.
Importancia de la gestión de versiones de Python
Las versiones de Python evolucionan constantemente: se añaden nuevas funciones y parches de seguridad, pero también existen programas que solo funcionan en versiones más antiguas. Por eso, poder alternar entre diferentes versiones según el proyecto es esencial para un desarrollo eficiente.
Ventajas de combinar Ubuntu y pyenv
Ubuntu es un sistema operativo muy popular entre desarrolladores, y configurar entornos de Python en él es bastante sencillo. Usar pyenv en Ubuntu permite instalar y alternar entre diferentes versiones de Python sin afectar el entorno global del sistema, facilitando la gestión del entorno de desarrollo.
2. ¿Qué es pyenv?
pyenv es una herramienta para gestionar fácilmente múltiples versiones de Python en un mismo sistema. Tradicionalmente, para usar una versión específica era necesario instalarla en todo el sistema. Con pyenv, en cambio, se pueden instalar versiones independientes por usuario o proyecto, lo que simplifica enormemente la gestión.
Principales funciones de pyenv
- Gestión de múltiples versiones: Permite instalar y usar varias versiones de Python en un solo sistema.
- Cambio de versiones: Facilita alternar entre versiones específicas de Python según cada proyecto.
- Integración con entornos virtuales: Al combinarlo con
venvopyenv-virtualenv, se pueden administrar entornos virtuales de forma sencilla.
Por qué pyenv es útil
En muchos entornos de desarrollo, un proyecto puede requerir la versión más reciente de Python mientras otro necesita una más antigua. pyenv resulta ideal para estos casos, ya que permite mantener la compatibilidad entre proyectos mediante el uso flexible de diferentes versiones.
3. Cómo instalar pyenv en Ubuntu
Para instalar pyenv en Ubuntu, primero es necesario configurar algunos paquetes de dependencias que garantizan su correcto funcionamiento.
Instalación de los paquetes requeridos
Primero, instala los paquetes necesarios con los siguientes comandos:
sudo apt update
sudo apt install make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-devInstalación de pyenv
El método más común es clonar directamente desde GitHub:
curl https://pyenv.run | bashConfiguración de variables de entorno
Agrega las siguientes líneas en ~/.bashrc (o ~/.zshrc) para que pyenv funcione correctamente:
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"Una vez hecho esto, reinicia la terminal o ejecuta source ~/.bashrc para aplicar los cambios.

4. Instalación y gestión de versiones de Python
Con pyenv instalado, ya puedes proceder a instalar diferentes versiones de Python y alternar entre ellas según lo necesites.
Comprobar e instalar versiones de Python
Lista todas las versiones disponibles con:
pyenv install --listElige la versión que quieras instalar:
pyenv install 3.10.8Cambiar de versión
Para establecer una versión global:
pyenv global 3.10.8Para usar una versión específica en un proyecto, configura el directorio con:
pyenv local 3.10.85. Crear entornos virtuales con pyenv
Además de gestionar versiones, es recomendable usar entornos virtuales para aislar dependencias en cada proyecto.
Uso de venv
Ubuntu incluye venv como parte de la librería estándar de Python. Puedes crear un entorno virtual con:
python -m venv .venvActivar el entorno virtual:
source .venv/bin/activateDesactivarlo:
deactivate6. Solución de problemas con pyenv
En ocasiones, ciertas versiones pueden no instalarse correctamente o presentarse errores en la configuración de PATH.
Errores comunes y soluciones
- Error al instalar versiones: Verifica que todas las dependencias estén instaladas con
sudo apt install. - PATH mal configurado: Si no se cambia la versión, revisa que
~/.bashrccontenga la configuración correcta y ejecutasource ~/.bashrc.
7. Configuración avanzada y usos
Una vez dominado lo básico, puedes mejorar aún más tu entorno con plugins y herramientas adicionales.
Uso de pyenv-virtualenv
Un plugin muy popular es pyenv-virtualenv, que facilita la gestión de múltiples entornos virtuales.
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenvCrear y activar un entorno:
pyenv virtualenv 3.10.8 myenv
pyenv activate myenvDesactivar el entorno:
pyenv deactivateIntegración con otras herramientas de gestión
- Homebrew: Aunque es más común en Mac, también puede usarse en Ubuntu:
brew install pyenv - Miniconda: Una herramienta ligera para gestionar paquetes de Python. Se puede instalar con pyenv:
pyenv install miniconda3-latest

8. Conclusión
En este artículo vimos cómo usar pyenv en Ubuntu para gestionar entornos de Python. Aprendiste a instalar múltiples versiones, crear entornos virtuales y resolver errores comunes.
Glosario de términos
- Gestión de versiones = version management
- Entorno virtual = virtual environment
- Dependencias = dependencies
- Configuración de PATH = PATH configuration
- Paquetes = packages
- Plugin = plugin
- Variables de entorno = environment variables
- Terminal = terminal
目次 1 1. pyenvとは?1.1 Pythonバージョン管理の課題1.2 pyenvの利点1.3 pyenvの仕組…




