1. Introduction
Lorsque vous développez en Python sous Ubuntu, il est fréquent d’avoir besoin de versions différentes de Python pour différents projets. Dans ces cas‑ci, l’outil de gestion de versions pyenv devient extrêmement utile. Cet article explique comment gérer facilement plusieurs versions de Python sur Ubuntu à l’aide de pyenv.
L’importance de la gestion des versions de Python
Les versions de Python évoluent chaque année, ajoutant de nouvelles fonctionnalités et des correctifs de sécurité, tandis que certains programmes ne fonctionnent encore qu’avec d’anciennes versions. Il est donc essentiel de pouvoir basculer de façon flexible entre les versions requises pour chaque projet afin d’assurer un développement efficace.
Avantages d’utiliser Ubuntu avec pyenv
Ubuntu est un système d’exploitation très populaire parmi les développeurs, et la configuration des environnements Python y est fluide. En utilisant pyenv sur Ubuntu, vous pouvez installer facilement plusieurs versions de Python et basculer entre elles sans impacter l’environnement système, ce qui simplifie grandement la gestion des environnements de développement.
2. Qu’est‑ce que pyenv ?
pyenv est un outil conçu pour gérer facilement plusieurs versions de Python sur une même machine. Traditionnellement, l’utilisation d’une version spécifique de Python nécessitait son installation globale sur le système. Avec pyenv, vous pouvez installer différentes versions par utilisateur ou par projet, ce qui permet une gestion efficace des versions.
Principales fonctionnalités de pyenv
- Gestion de plusieurs versions : Installez et utilisez plusieurs versions de Python simultanément sur un même système.
- Basculement de version : Changez facilement de version de Python selon le projet.
- Intégration avec les environnements virtuels : Combinez pyenv avec des outils tels que
venvetpyenv-virtualenvpour gérer les environnements virtuels sans effort.
Pourquoi pyenv est pratique
Dans les environnements de développement, certains projets peuvent nécessiter la dernière version de Python, tandis que d’autres dépendent d’anciennes versions. pyenv est extrêmement utile dans ces scénarios, permettant aux développeurs de basculer entre les versions et d’éviter les problèmes de compatibilité entre différents projets.
3. Comment installer pyenv sur Ubuntu
Avant d’installer pyenv sur Ubuntu, plusieurs paquets de dépendances doivent être configurés. Ces dépendances sont essentielles au bon fonctionnement de pyenv.
Installation des dépendances requises
Tout d’abord, installez les paquets nécessaires avec les commandes suivantes :
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-dev
Installation de pyenv
Ensuite, installez pyenv. La méthode la plus courante consiste à le cloner directement depuis GitHub :
curl https://pyenv.run | bash
Configuration des variables d’environnement
Ajoutez le code suivant à ~/.bashrc (ou ~/.zshrc) afin que pyenv fonctionne correctement :
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
Cela termine l’installation de pyenv. Redémarrez votre shell ou exécutez source ~/.bashrc pour appliquer les changements.

4. Installation et gestion des versions de Python
Une fois pyenv installé, vous pouvez procéder à l’installation des versions de Python. Avec pyenv, il est simple d’installer une version précise de Python et de basculer entre elles selon les besoins.
Vérification des versions de Python disponibles et installation
Tout d’abord, listez toutes les versions de Python disponibles :
pyenv install --list
Sélectionnez la version que vous souhaitez installer et lancez :
pyenv install 3.10.8
Basculement de version de Python
Pour définir une version spécifique globalement, utilisez :
pyenv global 3.10.8
Pour définir une version localement dans un répertoire de projet particulier, utilisez pyenv local :
pyenv local 3.10.8
Cela vous permet de gérer de façon flexible les versions de Python requises.
5. Création d’environnements virtuels avec pyenv
En utilisant pyenv avec des environnements virtuels, vous pouvez maintenir des environnements Python indépendants pour chaque projet. Les environnements virtuels vous permettent d’installer et de gérer des bibliothèques et des paquets sans affecter les autres projets.
Utilisation de venv
Sur Ubuntu, vous pouvez facilement créer des environnements virtuels en utilisant la bibliothèque intégrée venv de Python. Créez un environnement virtuel avec :
python -m venv .venv
Activez l’environnement virtuel :
source .venv/bin/activate
Désactivez-le en utilisant :
deactivate
Utiliser des environnements virtuels simplifie la gestion des dépendances pour chaque projet.
6. Dépannage de pyenv
Lors de l’utilisation de pyenv, vous pouvez rencontrer des erreurs telles que l’échec d’installation de versions spécifiques de Python ou des problèmes liés aux paramètres PATH. Voici les problèmes courants et leurs solutions :
Erreurs courantes et solutions
- Échec de l’installation d’une version : cela peut se produire si des dépendances requises sont manquantes. Installez les paquets manquants avec
sudo apt install. - Configuration PATH incorrecte : si le changement de version Python ne fonctionne pas, vérifiez que les paramètres PATH sont correctement ajoutés à
~/.bashrcet réappliquez les paramètres en utilisantsource ~/.bashrc.
7. Paramètres avancés et utilisation
Une fois que vous maîtrisez les bases de pyenv, vous pouvez explorer les paramètres et fonctionnalités avancés. Cette section explique comment améliorer votre environnement en utilisant des plugins et d’autres outils de gestion de paquets.
Utilisation de pyenv-virtualenv
pyenv prend en charge les plugins, et l’un des plus couramment utilisés est pyenv-virtualenv. Cela permet une gestion plus efficace des environnements virtuels Python. En utilisant pyenv virtualenv, vous pouvez gérer plusieurs environnements virtuels et créer des environnements séparés pour chaque projet.
Comment installer pyenv-virtualenv :
- Assurez‑vous que pyenv est déjà installé.
- Installez
pyenv-virtualenven utilisant la commande suivante :git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
- Créez un environnement virtuel et activez‑le en utilisant :
pyenv virtualenv 3.10.8 myenv pyenv activate myenv
- Pour désactiver l’environnement, utilisez
pyenv deactivate.
Intégration avec d’autres outils de gestion de paquets
Lors du développement sur Ubuntu, vous pouvez combiner pyenv avec d’autres gestionnaires de paquets. Des outils comme Homebrew et Miniconda sont utiles pour installer des bibliothèques et frameworks supplémentaires.
- Intégration Homebrew : Bien que Homebrew soit largement utilisé sur macOS, il fonctionne également sur Ubuntu. Pour installer pyenv avec Homebrew, exécutez :
brew install pyenv
- Intégration Miniconda : Miniconda est un gestionnaire de paquets Python léger. Le combiner avec pyenv vous permet d’utiliser différentes versions de Python et ensembles de paquets par environnement. Vous pouvez installer Miniconda en utilisant
pyenv install.
8. Conclusion
Cet article a présenté comment gérer les environnements Python sur Ubuntu en utilisant pyenv. Nous avons couvert l’installation de plusieurs versions de Python, la création d’environnements virtuels et le dépannage des problèmes courants.