Comment réparer l'erreur pip « environnement géré en externe » sous Linux

Si vous travaillez fréquemment avec Python et que vous êtes récemment passé à Ubuntu 23.04 ou Fedora version 38, il y a de fortes chances que vous j'ai rencontré l'erreur "environnement géré en externe" lors de l'installation de packages avec le gestionnaire de packages Python, pépin.

Cela pourrait être frustrant et assez surprenant car cette erreur n'apparaîtrait jamais dans les anciennes versions d'Ubuntu, Fedora et d'autres distributions. Apprenons quelle est exactement la cause de cette erreur et comment vous pouvez la corriger rapidement.

Pourquoi l'erreur « environnement géré en externe » se produit

Les dernières versions de toutes les distributions Linux adoptent les normes définies dans PEP-668. Ces modifications garantissent que les packages pip ne seront pas installés dans un contexte global par défaut.

Cela a été implémenté pour tenter d'éviter les conflits entre le gestionnaire de packages de la distribution et les outils de gestion de packages Python. Vous pouvez en apprendre davantage sur les détails dans le

documentation officielle PEP-668. Si vous souhaitez annuler ou remplacer ce mécanisme, vous pouvez adopter trois approches.

1. Supprimez le fichier « GÉRÉ EN EXTERNE »

Il s'agit de la solution la plus simple à l'erreur pip « gérée en externe ». Tout ce que vous avez à faire est de naviguer vers /usr/lib/python3.xx et supprimez le GÉRÉ EN EXTERNE fichier dans le répertoire. Voici les commandes pour le faire :

cd /usr/lib/python3.11
sudo rm EXTERNALLY-MANAGED

C'est tout ce que vous devez faire pour corriger l'erreur. Si vous choisissez de restaurer ce mécanisme, créez à nouveau le même fichier avec la commande tactile:

sudo touch EXTERNALLY-MANAGED

Vous devriez maintenant pouvoir installer des packages de manière transparente avec pip ou pip3.

2. Utiliser des environnements virtuels pour installer les packages pip

Une autre approche que vous pouvez adopter consiste à utiliser environnements virtuels pour votre projet Python. Les environnements virtuels sont un excellent moyen d'isoler les packages spécifiques au programme du système d'exploitation et vous permettent également d'organiser proprement votre projet.

Voici comment créer un environnement virtuel et installer des packages avec pip :

1. Tout d’abord, créez l’environnement virtuel avec :

   python3 -m venv venv

2. Sourcez le fichier d'activation dans le répertoire bin à l'aide de la commande source :

   source venv/bin/activate

L'invite de votre shell doit être mise à jour avec le nom de l'environnement virtuel. Vous pourrez désormais installer tous les packages Python de votre choix.

Comme vous pouvez le constater, le ouvert Le package Python n'a pas pu être installé au début, mais après avoir créé et basculé vers un environnement virtuel, il est installé parfaitement.

3. Utilisez pipx pour installer les packages Python

pipx est un utilitaire permettant d'installer des packages Python dans des environnements virtuels et isolés. Il automatise des étapes telles que la création d'environnements virtuels pour chaque package et la création de liens symboliques vers les packages dans le .local/bin dossier afin que vous puissiez appeler chaque package depuis le shell à tout moment.

L'utilisation de pipx pour installer des packages vous aide à éviter l'erreur « environnement géré en externe » lors de l'installation des packages dans des environnements virtuels. Pour utiliser pipx, installez-le d’abord avec le gestionnaire de packages par défaut de votre distribution.

Sur les dérivés Ubuntu/Debian :

sudo apt-get install pipx

Sur les systèmes basés sur Arch :

sudo pacman -S pipx

Sur Fedora/CentOS/RHEL :

sudo dnf install pipx

Une fois que vous avez installé pipx, utilisez-le comme vous utiliseriez pip pour installer des packages. Voici un exemple de commande :

pipx install openai

Pour en savoir plus sur pipx, vous pouvez vous référer à sa page de manuel à l'aide de la commande man.

Vous savez maintenant comment corriger l'erreur « géré en externe »

Après avoir corrigé l'erreur « environnement géré en externe », vous devriez pouvoir continuer à travailler sur votre projet ou à pratiquer la programmation Python générale. Si vous vous concentrez sur ce dernier point, vous voudrez peut-être découvrir les différentes méthodes d'apprentissage gamifiées. une programmation qui vous aidera à apprendre Python ou tout autre langage beaucoup plus rapidement de manière pratique et enrichissante chemin.