Linux 使用pip报错(error: externally-managed-environment )解决方案

**报错输出如下:**error: externally-managed-environment
点击查看代码

复制代码
zhuji@hcss-ecs-2045:~/$ sudo pip3 install -r requirements.txt 
[sudo] zhuji 的密码:
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
    sure you have python3-full installed.
    
    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.
    
    See /usr/share/doc/python3.11/README.venv for more information.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

造成原因:

这个错误提示说明当前Python环境是由操作系统外部管理的(通常是因为使用了系统自带的Python),

为了避免破坏系统环境,建议使用虚拟环境或者使用系统包管理器(apt)来安装包。

根据提示,我们可以采取以下几种方法之一:

方法1:使用apt安装对应的包(如果存在的话)

但是这里我们是通过requirements.txt安装,可能包不在系统仓库中。

方法2:使用虚拟环境(推荐)

步骤:

1.创建一个虚拟环境
点击查看代码

复制代码
确保安装了python3-venv(如果没有,请先安装)
sudo apt install python3-venv
在项目目录下创建虚拟环境(假设虚拟环境目录名为venv)
python3 -m venv venv

2.激活虚拟环境,在虚拟环境中安装requirements.txt中的包
点击查看代码

复制代码
激活虚拟环境
source venv/bin/activate
然后使用pip安装requirements.txt中的包
pip install -r requirements.txt

3.当不再使用时,可以退出虚拟环境 关闭虚拟环境后,下载的pip包会自动消失 点击查看代码

复制代码
当不再使用时,可以退出虚拟环境(关闭虚拟环境后,下载的pip包会自动消失)
deactivate

方法3:

使用pipx(适用于安装Python应用程序,但这里是一组包,可能不太适合)
点击查看代码

复制代码
# 安装 pipx
sudo apt install pipx

# 用 pipx 安装包(示例)
pipx install 包名

方法4:

忽略警告(不推荐),使用--break-system-packages参数,但这样可能会破坏系统环境。
点击查看代码

复制代码
# 如果坚持安装到系统环境(可能破坏系统稳定性),可添加 --break-system-packages 参数:
sudo pip3 install --break-system-packages -r requirements.txt
相关推荐
Nicole-----4 小时前
Python - Union联合类型注解
开发语言·python
yaoxtao4 小时前
java.nio.file.InvalidPathException异常
java·linux·ubuntu
2501_920047036 小时前
git在Linux中的使用
linux·git·elasticsearch
程序设计实验室7 小时前
在鸡哥14x上安装Linux:Fedora 42 上手体验
linux
Eric.5657 小时前
python advance -----object-oriented
python
UNbuff_07 小时前
Linux bzip2 命令使用说明
linux·运维·服务器
云天徽上7 小时前
【数据可视化-107】2025年1-7月全国出口总额Top 10省市数据分析:用Python和Pyecharts打造炫酷可视化大屏
开发语言·python·信息可视化·数据挖掘·数据分析·pyecharts
THMAIL7 小时前
机器学习从入门到精通 - 数据预处理实战秘籍:清洗、转换与特征工程入门
人工智能·python·算法·机器学习·数据挖掘·逻辑回归
@HNUSTer7 小时前
Python数据可视化科技图表绘制系列教程(六)
python·数据可视化·科技论文·专业制图·科研图表