pip install -r requirements.txt执行失败，提示“This environment is externally managed”

这个报错是PEP 668规范的实现，常见于Debian、Ubuntu等基于Debian的发行版。系统将自带的Python环境标记为「外部管理环境」，目的是避免pip安装的包与系统包管理器（如apt）维护的包产生依赖冲突，防止破坏系统的Python运行环境。

解决方案 #

1. 使用系统包管理器安装（优先推荐系统存在的包） #

如果requirements.txt中的包有对应的Debian官方打包版本，直接用apt安装：

sudo apt install python3-<包名>

比如安装requests包，执行：

sudo apt install python3-requests

2. 创建虚拟环境（推荐用于自定义包安装） #

虚拟环境可以隔离项目依赖，避免影响系统环境：

• 创建虚拟环境：

  python3 -m venv my_project_env  # my_project_env可替换为任意路径/名称
  

• 激活虚拟环境：

  source my_project_env/bin/activate  # Linux/macOS
  # Windows PowerShell执行：.\my_project_env\Scripts\Activate.ps1
  

• 激活后直接执行安装命令：

  pip install -r requirements.txt
  

• 退出虚拟环境：

  deactivate
  

3. 使用pipx安装Python应用 #

如果是要安装可直接运行的Python工具（如black、flake8），pipx会自动为每个应用创建独立虚拟环境，无需手动管理：

• 先安装pipx：

  sudo apt install pipx
  

• 安装应用：

  pipx install <应用名称>
  

4. 强制覆盖（不推荐） #

仅在确认不会破坏系统环境的情况下使用，通过添加--break-system-packages参数强制绕过限制：

pip install -r requirements.txt --break-system-packages

该操作可能导致系统Python依赖混乱，引发未知问题，谨慎使用。

内容的提问来源于stack exchange，提问作者iReXes