宝塔面板如何安装Python项目_创建虚拟环境与依赖管理-php教程-PHP中文网

宝塔面板中不能直接用 python -m venv 创建虚拟环境，因默认调用系统python路径（如/usr/bin/python），而面板实际使用的是独立安装路径（如/www/server/python/bin/python3.11）；必须用完整路径创建环境，并确保项目配置中的python版本、venv路径、用户权限及启动文件路径完全匹配。

宝塔面板如何安装python项目_创建虚拟环境与依赖管理

宝塔面板里不能直接用 `python -m venv`？先确认 Python 版本和路径

宝塔默认可能装的是系统 Python（如 /usr/bin/python），但你实际在面板里选的 Python 版本（比如 3.9、3.11）其可执行文件其实在 /www/server/python/bin/python3.x。直接在终端敲 python -m venv 很可能调用错解释器，生成的虚拟环境不兼容后续部署。

进宝塔 → 软件商店 → 找到你安装的 Python 版本 → 点“设置” → 看“Python 主程序路径”，复制下来（例如 /www/server/python/bin/python3.11）
SSH 进服务器，在项目目录下用完整路径创建环境：
```
/www/server/python/bin/python3.11 -m venv venv
```
别用 python3 -m venv —— 宝塔里多个 Python 共存时，python3 指向不确定，容易踩坑

用宝塔部署 Flask/Django 时，`requirements.txt` 安装失败常见原因

不是 pip 版本低就是源没切对，更常见的是权限或路径问题。宝塔面板后台运行的进程默认以 www 用户身份执行，但你在 SSH 用 root 装的包不会自动生效。

进项目目录后，**必须激活虚拟环境再装依赖**：
```
source venv/bin/activate && pip install -r requirements.txt
```

如果报 ReadTimeoutError 或下载慢，换清华源：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

某些包（如 psycopg2、mysqlclient）需要系统级开发头文件，得先在宝塔软件商店装“Development Tools”或手动运行：
```
yum groupinstall "Development Tools" && yum install python3-devel postgresql-devel
```

宝塔面板配置 Python 项目时，`项目根目录` 和 `wsgi.py` 路径怎么填才不 404

面板里“网站”→“添加站点”后点“Python 项目”，填的不是整个代码仓库路径，而是框架启动入口所在目录。填错会导致找不到 app 对象或 application 变量。

Flask 项目：假设结构是 /www/wwwroot/myflask/app.py，且里面有 app = Flask(__name__)，那么：
- 项目根目录 填 /www/wwwroot/myflask（不是 /www/wwwroot/myflask/app.py）
- 启动文件 填 app.py
- 应用入口 填 app（变量名，大小写敏感）
Django 项目：入口是 myproject/wsgi.py 中的 application，所以：
- 项目根目录 填 /www/wwwroot/mydjango（即 manage.py 同级）
- 启动文件 填 myproject/wsgi.py（注意带子目录）
- 应用入口 填 application
务必确认 venv 路径在项目根目录下，且面板里“Python 版本”下拉框选的是你创建环境时用的那个版本（比如 3.11，不是系统默认的 3.6）

重启项目后依赖还在但报 `ModuleNotFoundError`？检查 `sys.path` 和用户上下文

宝塔 Python 项目插件启动时会自动激活虚拟环境，但如果你手动改过 venv 名字、移动过目录，或者用 root 装了包却没给 www 用户读取权限，就会出现“明明装了却找不到”的情况。

在项目根目录下加个临时调试脚本 debug_path.py，内容为：
```
import sys; print('\n'.join(sys.path))
```
，然后在面板里“运行命令”执行它，看输出里有没有你的 venv/lib/python3.x/site-packages
检查 venv 目录权限：
```
ls -ld venv && ls -l venv/bin/
```
，确保 www 用户有执行 venv/bin/activate 的权限（至少是 755）
别把 venv 放在 /tmp 或其他被宝塔清理策略覆盖的路径下——它会被定时清掉