需通过虚拟环境实现依赖隔离：一、确认Python及pip可用；二、用venv创建虚拟环境；三、用宝塔Python项目管理器图形化创建；四、激活并安装依赖；五、配置项目使用指定虚拟环境解释器。

如果您在宝塔面板中部署多个Python项目，但各项目依赖的库版本存在冲突，则需通过虚拟环境实现依赖隔离。以下是具体操作步骤：

一、确认系统已安装Python及pip

宝塔面板默认可能未启用或未完整配置Python运行环境，需先验证基础工具链是否可用。虚拟环境依赖系统级Python解释器和pip包管理器，缺失任一将导致venv模块无法调用。

1、登录宝塔面板，进入【软件商店】，搜索“Python项目管理器”并确保已安装启用。

2、打开【终端】，执行命令 python3 --version 检查Python 3版本是否为3.6及以上。

立即学习“Python免费学习笔记（深入）”；

3、执行命令 pip3 --version 确认pip3可用且路径正常。

二、使用venv模块创建虚拟环境

Python 3.3+内置venv模块，无需额外安装第三方工具，适用于大多数宝塔Linux环境（CentOS/Ubuntu/Debian），生成轻量、独立的Python运行目录。

1、通过宝塔【文件】功能，进入目标项目根目录（如 /www/wwwroot/myproject）。

2、点击右上角【终端】按钮，在当前路径下执行：python3 -m venv venv。

3、执行 ls -la 查看是否生成名为 venv 的新目录。

三、通过宝塔Python项目管理器自动创建

宝塔内置的Python项目管理器可图形化完成虚拟环境初始化与启动配置，避免手动输入命令出错，尤其适合不熟悉Shell操作的用户。

1、进入【网站】→ 选择对应站点 → 点击【Python项目管理器】。

2、在【Python版本】下拉菜单中选择已安装的Python 3.x版本。

3、在【虚拟环境路径】栏填写绝对路径，例如：/www/wwwroot/myproject/venv。

4、勾选【自动创建虚拟环境】，点击【提交】，系统将自动执行创建并检测环境有效性。

四、激活虚拟环境并安装依赖

虚拟环境创建后必须显式激活才能使pip和python命令指向该环境，否则所有安装操作仍作用于系统Python。

1、在【终端】中切换至项目目录：cd /www/wwwroot/myproject。

2、执行激活命令：source venv/bin/activate（Linux）或 venv\Scripts\activate.bat（Windows，宝塔不适用）。

3、激活成功后，命令行提示符前会出现 (venv) 标识。

4、执行 pip install -r requirements.txt 安装项目所需依赖。

五、配置宝塔Python项目使用指定虚拟环境

仅创建虚拟环境不足以让Web服务调用其中的Python解释器和包，必须在宝塔项目配置中明确指定解释器路径，否则请求仍将由系统Python处理。

1、进入【网站】→ 对应站点 → 【Python项目管理器】。

2、在【Python路径】字段中填写虚拟环境内Python解释器的绝对路径，例如：/www/wwwroot/myproject/venv/bin/python。

3、在【项目路径】中确认为项目主程序所在目录（含app.py或wsgi.py等入口文件）。

4、点击【重启项目】，宝塔将使用该虚拟环境中的Python启动服务进程。