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 文件夹，如没有则创建 |