1. Introduction
Lorsque vous développez avec Python sur Ubuntu, vous avez souvent besoin de différentes versions de Python pour différents projets. Dans de tels cas, « pyenv » est un outil de gestion de versions extrêmement utile. Cet article explique comment gérer facilement plusieurs versions de Python sur Ubuntu en utilisant pyenv.
L’importance de la gestion des versions de Python
Les versions de Python évoluent chaque année, introduisant de nouvelles fonctionnalités et des correctifs de sécurité. Cependant, certains programmes ne fonctionnent qu’avec des versions plus anciennes. Ainsi, passer efficacement d’une version requise à une autre pour des projets spécifiques est essentiel pour un développement fluide.
Avantages d’utiliser pyenv sur Ubuntu
Ubuntu est un système d’exploitation populaire parmi les développeurs et offre une configuration fluide pour les environnements Python. Utiliser pyenv sur Ubuntu vous permet d’installer facilement différentes versions de Python et de basculer entre elles sans affecter l’environnement système, rendant la gestion des environnements de développement plus pratique.
2. Qu’est‑ce que pyenv ?
pyenv est un outil qui permet de gérer facilement plusieurs versions de Python sur le même système. Traditionnellement, l’utilisation d’une version spécifique de Python nécessitait son installation à l’échelle du système. Cependant, avec pyenv, vous pouvez installer des versions indépendantes par utilisateur ou par projet, ce qui simplifie grandement la gestion des versions.
Fonctionnalités clés de pyenv
- Gérer plusieurs versions: Installer et utiliser plusieurs versions de Python sur un seul système simultanément.
- Passer entre les versions: Passez facilement entre les versions Python par projet selon les besoins.
- Intégration avec les environnements virtuels: Fonctionne sans accroc avec des outils tels que venv et pyenv-virtualenv pour une gestion efficace des environnements virtuels.
Pourquoi pyenv est utile
En développement, certains projets nécessitent la dernière version de Python, tandis que d’autres dépendent d’anciennes versions. pyenv est extrêmement utile dans ces cas, vous permettant d’utiliser différentes versions selon les besoins, éliminant ainsi les problèmes de compatibilité entre les projets.
3. Comment installer pyenv sur Ubuntu
Pour installer pyenv sur Ubuntu, vous devez d’abord installer plusieurs paquets de dépendances. Ces dépendances sont essentielles au bon fonctionnement de pyenv.
Installation des dépendances requises
Tout d’abord, installez les paquets nécessaires en utilisant 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
Définition des variables d’environnement
Pour que pyenv fonctionne correctement, ajoutez les lignes suivantes à votre ~/.bashrc
(ou ~/.zshrc
) :
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
Maintenant, pyenv est installé avec succès. 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é, l’étape suivante consiste à installer une version de Python. Avec pyenv, vous pouvez facilement installer une version spécifique de Python et basculer entre elles selon les besoins.
Vérification et installation des versions de Python
Tout d’abord, affichez la liste des versions de Python disponibles :
pyenv install --list
À partir de la liste affichée, choisissez la version que vous souhaitez installer et exécutez la commande suivante :
pyenv install 3.10.8
Changement de version de Python
Pour définir une version spécifique comme défaut global, utilisez la commande suivante :
pyenv global 3.10.8
Pour changer de version par projet, utilisez la pyenv local
qui ne s’applique que dans le répertoire spécifique :
pyenv local 3.10.8
Cela vous permet de gérer de manière flexible les versions de Python requises.
5. Création d’environnements virtuels avec pyenv
En plus d’utiliser pyenv, exploiter les environnements virtuels vous permet de maintenir des environnements Python isolés pour chaque projet. Les environnements virtuels sont un outil pratique pour installer et gérer des bibliothèques et des paquets sans affecter les autres projets.
Utilisation de venv
Sur Ubuntu, vous pouvez créer un environnement virtuel en utilisant le module intégré venv
module. Exécutez la commande suivante pour créer un environnement virtuel :
python -m venv .venv
Après création, activez l’environnement virtuel avec la commande suivante :
source .venv/bin/activate
Pour désactiver l’environnement virtuel, utilisez :
deactivate
En utilisant des environnements virtuels, vous pouvez gérer les dépendances de chaque projet de manière indépendante.
6. Dépannage de pyenv
Lorsque vous utilisez pyenv, vous pouvez rencontrer des problèmes tels que des échecs d’installation ou des erreurs liées à la configuration du PATH. Vous trouverez ci‑dessous les problèmes courants et leurs solutions.
Erreurs courantes et solutions
- Échec de l’installation: Si une version de Python échoue à s’installer, cela peut être dû à des dépendances manquantes. Utilisez
sudo apt install
pour installer les packages requis. - Configuration PATH incorrecte: Si les versions de Python ne passent pas correctement, vérifiez que votre
~/.bashrc
contient les paramètres PATH corrects. Appliquez les modifications en exécutantsource ~/.bashrc
.
7. Configuration avancée et utilisation
Une fois que vous êtes à l’aise avec l’utilisation de base de pyenv, vous pouvez explorer les paramètres avancés et les techniques d’utilisation. Cette section couvre l’utilisation des plugins, l’intégration avec d’autres gestionnaires de paquets et l’optimisation de votre flux de travail de développement.
Utilisation de pyenv-virtualenv
pyenv prend en charge les plugins, et l’un des plus utiles est pyenv-virtualenv. Cet outil améliore la gestion des environnements virtuels, vous permettant de gérer plusieurs environnements efficacement. Avec pyenv virtualenv
, vous pouvez facilement créer et basculer entre différents environnements virtuels.
Comment installer pyenv-virtualenv :
- Tout d’abord, assurez-vous que pyenv est installé sur votre système.
- Ensuite, installez
pyenv-virtualenv
en 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 les commandes suivantes :
pyenv virtualenv 3.10.8 myenv
pyenv activate myenv
- Pour désactiver l’environnement virtuel, utilisez
pyenv deactivate
.
Intégration avec d’autres gestionnaires de paquets
Lors du développement sous Ubuntu, vous pouvez utiliser pyenv
en parallèle avec d’autres gestionnaires de paquets tels que Homebrew ou Miniconda. Ces outils peuvent aider à installer des bibliothèques et des frameworks supplémentaires.
- Utilisation de Homebrew: Bien que Homebrew soit plus courant sur macOS, il est également disponible pour Ubuntu. Pour installer pyenv via Homebrew, utilisez :
brew install pyenv
- Utilisation de Miniconda: Miniconda est un gestionnaire de paquets Python léger. Vous pouvez l’installer via
pyenv install
pour gérer différentes versions de Python et ensembles de paquets par environnement.

8. Conclusion
Dans cet article, nous avons expliqué comment gérer les environnements Python sur Ubuntu à l’aide de pyenv. Nous nous sommes concentrés sur l’installation de plusieurs versions de Python, la création d’environnements virtuels et le dépannage des problèmes courants.
目次 1 1. pyenvとは?1.1 Pythonバージョン管理の課題1.2 pyenvの利点1.3 pyenvの仕組…