78 lines
1.8 KiB
Markdown
78 lines
1.8 KiB
Markdown
|
# Python 环境配置指南
|
|||
|
|
|
|||
|
|
## 前提条件
|
|||
|
|
- 已安装 Conda（Anaconda 或 Miniconda）
|
|||
|
|
- Windows 操作系统
|
|||
|
|
|
|||
|
|
## 自动配置方法
|
|||
|
|
|
|||
|
|
1. 双击项目根目录中的 `setup_py_env.bat` 文件
|
|||
|
|
2. 等待脚本完成环境配置和依赖安装
|
|||
|
|
3. 环境配置完成后，窗口会显示使用说明
|
|||
|
|
|
|||
|
|
## 手动配置方法
|
|||
|
|
|
|||
|
|
如果自动配置方法不起作用，请按照以下步骤手动配置：
|
|||
|
|
|
|||
|
|
1. 打开命令提示符（CMD）或 PowerShell
|
|||
|
|
2. 创建新的 Conda 环境：
|
|||
|
|
```
|
|||
|
|
conda create -n fast-dashboard-env python=3.11 -y
|
|||
|
|
```
|
|||
|
|
3. 激活环境：
|
|||
|
|
```
|
|||
|
|
conda activate fast-dashboard-env
|
|||
|
|
```
|
|||
|
|
4. 安装项目依赖：
|
|||
|
|
```
|
|||
|
|
cd 项目根目录
|
|||
|
|
pip install -r backend/requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 运行后端服务器
|
|||
|
|
|
|||
|
|
1. 激活 Conda 环境（如果尚未激活）：
|
|||
|
|
```
|
|||
|
|
conda activate fast-dashboard-env
|
|||
|
|
```
|
|||
|
|
2. 进入后端目录：
|
|||
|
|
```
|
|||
|
|
cd backend
|
|||
|
|
```
|
|||
|
|
3. 启动服务器：
|
|||
|
|
```
|
|||
|
|
uvicorn main:app --reload
|
|||
|
|
```
|
|||
|
|
4. 服务器将在 http://127.0.0.1:8000 启动
|
|||
|
|
|
|||
|
|
## 环境依赖列表
|
|||
|
|
|
|||
|
|
本项目使用以下 Python 库：
|
|||
|
|
|
|||
|
|
- fastapi==0.109.2
|
|||
|
|
- uvicorn==0.27.1
|
|||
|
|
- pydantic==2.6.1
|
|||
|
|
- python-multipart==0.0.9
|
|||
|
|
- python-jose==3.3.0
|
|||
|
|
- passlib==1.7.4
|
|||
|
|
- bcrypt==4.1.2
|
|||
|
|
- requests==2.31.0
|
|||
|
|
- beautifulsoup4==4.12.2
|
|||
|
|
- sqlalchemy==2.0.26
|
|||
|
|
- aiosqlite==0.19.0
|
|||
|
|
- alembic==1.13.1
|
|||
|
|
|
|||
|
|
## 常见问题
|
|||
|
|
|
|||
|
|
1. **无法激活 Conda 环境**
|
|||
|
|
- 确保已正确安装 Conda
|
|||
|
|
- 尝试重新打开终端
|
|||
|
|
- 运行 `conda init powershell`（如果使用 PowerShell）
|
|||
|
|
|
|||
|
|
2. **依赖安装失败**
|
|||
|
|
- 检查网络连接
|
|||
|
|
- 尝试使用镜像源：`pip install -r backend/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple`
|
|||
|
|
|
|||
|
|
3. **启动服务器时出错**
|
|||
|
|
- 确保所有依赖都已正确安装
|
|||
|
|
- 检查 backend 目录下是否有 data 文件夹，如没有则创建
|