禁止用pip在系统全局Python环境安装包的解决办法

禁止用pip在系统全局Python环境安装包的解决办法

本文是 Handsome 主题博客的美化记录教程,以插件方式实现站点美化,操作前需做好备份。介绍三款插件:UserAgent 插件,需修改 comments.php 代码展示用户 UA;CommentToMail 用于邮箱评论通知;还有随机循环评论弹窗插件,分别给出下载地址与上传激活步骤。

报错原因

Debian/Ubuntu 新版系统(Python3.10+)引入了 PEP 668,禁止直接用 pip 在系统全局 Python 环境安装包,防止破坏系统自带 Python,所以抛出 externally-managed-environment。

不推荐直接加 --break-system-packages,容易把系统 Python 搞崩,导致 apt 等工具异常。优先使用虚拟环境。

方案 1:使用虚拟环境(推荐,生产 / 项目部署首选)

text
# 进入项目目录
cd /www/wwwroot/Friend-Circle-Lite

# 安装虚拟环境依赖
apt update && apt install python3-venv python3-full -y

# 创建venv
python3 -m venv venv

# 激活虚拟环境
source venv/bin/activate

# 此时前面会出现 (venv),再安装依赖
pip install -r ./requirements.txt

后续启动项目,都需要先激活虚拟环境:

text
source venv/bin/activate
# 然后启动项目

退出虚拟环境命令:

text
deactivate

方案 2:临时强制全局安装(不推荐,仅测试用,风险高)

⚠️ 风险:可能损坏系统 Python,apt 命令失效,仅应急测试

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

方案 3:pipx(适合独立 Python 应用,不适合 web 项目)

pipx 适合安装单个可执行程序,这个圈子项目不适用,不推荐。

微信支付
支付宝
QQ

感谢您的支持,这将激励我创作更多优质内容!

新故事即将发生
宝塔面板部署思源笔记

评论区

评论加载中...