82 lines
1.5 KiB
Plaintext
82 lines
1.5 KiB
Plaintext
|
# 虚拟环境使用指南
|
|||
|
|
|
|||
|
|
## 快速开始（推荐）
|
|||
|
|
|
|||
|
|
直接双击运行 `start.bat`，脚本会自动：
|
|||
|
|
1. 检查并创建虚拟环境
|
|||
|
|
2. 激活虚拟环境
|
|||
|
|
3. 安装依赖包
|
|||
|
|
4. 启动服务
|
|||
|
|
|
|||
|
|
## 手动使用虚拟环境
|
|||
|
|
|
|||
|
|
### Windows 系统
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 1. 创建虚拟环境
|
|||
|
|
python -m venv venv
|
|||
|
|
|
|||
|
|
# 2. 激活虚拟环境
|
|||
|
|
venv\Scripts\activate
|
|||
|
|
|
|||
|
|
# 3. 安装依赖
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
|
|||
|
|
# 4. 运行服务
|
|||
|
|
python app.py
|
|||
|
|
|
|||
|
|
# 5. 退出虚拟环境（使用完毕后）
|
|||
|
|
deactivate
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Linux/Mac 系统
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 1. 创建虚拟环境
|
|||
|
|
python3 -m venv venv
|
|||
|
|
|
|||
|
|
# 2. 激活虚拟环境
|
|||
|
|
source venv/bin/activate
|
|||
|
|
|
|||
|
|
# 3. 安装依赖
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
|
|||
|
|
# 4. 运行服务
|
|||
|
|
python app.py
|
|||
|
|
|
|||
|
|
# 5. 退出虚拟环境
|
|||
|
|
deactivate
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 配置说明
|
|||
|
|
|
|||
|
|
在启动服务前，需要配置 `.env` 文件：
|
|||
|
|
|
|||
|
|
**必须配置项：**
|
|||
|
|
- `ADSPOWER_USER_ID`: 在 AdsPower 中创建的用户 ID
|
|||
|
|
|
|||
|
|
**可选配置项：**
|
|||
|
|
- 其他配置项保持默认值即可
|
|||
|
|
|
|||
|
|
## 验证虚拟环境
|
|||
|
|
|
|||
|
|
激活虚拟环境后，命令行提示符前会显示 `(venv)`：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
(venv) D:\project\Work\ai_mip>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 常见问题
|
|||
|
|
|
|||
|
|
**Q: 如何确认已在虚拟环境中？**
|
|||
|
|
A: 命令行提示符前有 `(venv)` 标识
|
|||
|
|
|
|||
|
|
**Q: 虚拟环境在哪里？**
|
|||
|
|
A: 项目根目录下的 `venv` 文件夹
|
|||
|
|
|
|||
|
|
**Q: 需要每次都激活虚拟环境吗？**
|
|||
|
|
A: 使用 `start.bat` 会自动激活，手动运行需要先激活
|
|||
|
|
|
|||
|
|
**Q: 如何重建虚拟环境？**
|
|||
|
|
A: 删除 `venv` 文件夹，重新运行 `start.bat` 或手动创建
|