前言

现象

Manjaro 22、Ubuntu 23.04、Fedora 38 等最新的linux发行版中运行pip install时,通常会收到一个错误提示:error: externally-managed-environment,即“外部管理环境”错误,但这不是一个 bug。

背后的原因

“外部管理环境”错误背后的原因:Manjaro 22、Ubuntu 23.04、Fedora 38 以及其他的最新发行版中,正在使用 Python 包来实现此增强功能。

这个更新是为了避免「操作系统包管理器 (如pacman、yum、apt) 和 pip 等特定于 Python 的包管理工具之间的冲突」。

这些冲突包括 Python 级 API 不兼容和文件所有权冲突。

解决方案

方案一、(粗暴) 去掉这个提示

强制删除此警告,回归到熟悉的操作。

将 “x” 替换为实际版本。

命令:
sudo mv /usr/lib/python3.x/EXTERNALLY-MANAGED /usr/lib/python3.x/EXTERNALLY-MANAGED.bk

和之前一样,现在您可以直接运行 pip(3) install package_name 命令来安装python模块。

方案二、(推荐) 使用pipx

您在上面看到的涉及手动工作。Pipx 使其自动化

它会自动为您安装的每个应用程序创建一个新的虚拟环境。不仅。它还在 中创建指向它的链接.local/bin。这样,安装该软件包的用户就可以从命令行中的任何位置运行它。

我想这就是大多数桌面 Linux 用户想要的。

使用以下命令在 Ubuntu 上安装 pipx:

sudo apt install pipx1

它可能会安装大量的依赖项:

现在将其添加到 PATH 中,以便您可以从任何地方运行。

pipx ensurepath1

提示:

您必须关闭终端并重新登录才能发生更改。


现在我们可以使用 Pipx 而不是 Pip 安装 Python 包:

pipx install package_name1

提示:

要删除使用 pipx 安装的软件包,请使用 pipx uninstall package_name 命令。

方案三、(高阶) 使用venv

如果您是开发人员,

在运行或构建py文件时遇到如下图 ModuleNotFoundError: No module named 'xxx' 的错误,

推荐切换为该方案,即使用Python虚拟环境。

借助虚拟环境,您可以使用不同版本的包依赖项和Python。这样,您就可以避免包之间的任何冲突。

这种方法适合从事Python项目的软件开发人员和程序员。

安装 venv
sudo apt install python3-venv

#或

sudo apt install python3.10-venv

生成一个Python虚拟环境
mkdir -p $HOME/.env && python3 -m venv $HOME/.env/project_name

现在,您将看到一个.env在您的主目录中,并且在 .env 中,您将拥有项目目录。

每个虚拟环境项目目录中都会有自己的 Python 和 Pip 副本。

安装模块,如 algoliasearch
$HOME/.env/project_name/bin/python -m pip install --upgrade pip $HOME/.env/project_name/bin/python -m pip install algoliasearch
用新的虚拟环境执行py文件
source $HOME/.env/project_name/bin/activate $HOME/.env/project_name/bin/python ./demo.py