207 lines
4.7 KiB
Markdown
207 lines
4.7 KiB
Markdown
# Python环境管理器使用指南
|
||
|
||
## 🎯 功能概述
|
||
|
||
Python环境管理器是一个可视化界面，用于管理你的Tauri应用中的Python环境和依赖包。它支持：
|
||
|
||
- 📊 **环境状态监控** - 实时查看Python环境状态
|
||
- 📦 **包管理** - 安装、卸载、升级Python包
|
||
- 🔧 **环境设置** - 一键设置嵌入式Python环境
|
||
- 🔍 **包搜索** - 快速查找已安装的包
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 访问管理页面
|
||
|
||
在应用中：
|
||
1. 点击左侧导航栏的 "Python环境"
|
||
2. 或直接访问 `/python-env-manager` 路由
|
||
|
||
### 2. 查看环境状态
|
||
|
||
页面会显示两种Python环境的状态：
|
||
|
||
#### 嵌入式Python
|
||
- **优势**: 应用自带，用户无需安装
|
||
- **状态**: 绿色表示可用，红色表示未设置
|
||
- **设置**: 点击"设置嵌入式Python"按钮自动配置
|
||
|
||
#### 系统Python
|
||
- **优势**: 使用系统已安装的Python
|
||
- **状态**: 绿色表示可用，红色表示未安装
|
||
- **要求**: 需要用户系统已安装Python
|
||
|
||
## 📦 包管理功能
|
||
|
||
### 安装新包
|
||
|
||
1. 点击 "安装包" 按钮
|
||
2. 输入包名（如：`numpy`, `pandas`, `opencv-python`）
|
||
3. 点击 "安装" 按钮
|
||
4. 等待安装完成
|
||
|
||
**常用包推荐**：
|
||
- `requests` - HTTP请求库
|
||
- `Pillow` - 图像处理库
|
||
- `numpy` - 数值计算库
|
||
- `pandas` - 数据分析库
|
||
- `opencv-python` - 计算机视觉库
|
||
|
||
### 管理已安装的包
|
||
|
||
对于每个已安装的包，你可以：
|
||
|
||
- **升级** - 更新到最新版本
|
||
- **卸载** - 从环境中移除
|
||
|
||
### 搜索包
|
||
|
||
使用搜索框快速查找已安装的包：
|
||
- 输入包名进行实时搜索
|
||
- 支持模糊匹配
|
||
|
||
## 🔧 环境设置
|
||
|
||
### 设置嵌入式Python
|
||
|
||
如果嵌入式Python未设置（显示红色状态），可以：
|
||
|
||
1. 点击 "设置嵌入式Python" 按钮
|
||
2. 确认下载和安装（需要网络连接）
|
||
3. 等待自动完成设置
|
||
4. 刷新页面查看新状态
|
||
|
||
**设置过程包括**：
|
||
- 下载Python 3.11嵌入式版本
|
||
- 安装pip包管理器
|
||
- 安装基础依赖包
|
||
- 复制python_core模块
|
||
- 配置环境变量
|
||
|
||
### 环境优先级
|
||
|
||
应用会按以下优先级选择Python环境：
|
||
1. **嵌入式Python** - 如果可用，优先使用
|
||
2. **系统Python** - 作为备选方案
|
||
|
||
## 🛠️ 故障排除
|
||
|
||
### 常见问题
|
||
|
||
#### 1. 嵌入式Python设置失败
|
||
|
||
**可能原因**：
|
||
- 网络连接问题
|
||
- 磁盘空间不足
|
||
- 权限问题
|
||
|
||
**解决方案**：
|
||
- 检查网络连接
|
||
- 确保有足够磁盘空间（至少500MB）
|
||
- 以管理员权限运行应用
|
||
|
||
#### 2. 包安装失败
|
||
|
||
**可能原因**：
|
||
- 包名错误
|
||
- 网络问题
|
||
- 依赖冲突
|
||
|
||
**解决方案**：
|
||
- 检查包名拼写
|
||
- 确保网络连接正常
|
||
- 查看错误信息进行诊断
|
||
|
||
#### 3. 系统Python不可用
|
||
|
||
**可能原因**：
|
||
- 系统未安装Python
|
||
- Python未添加到PATH
|
||
|
||
**解决方案**：
|
||
- 安装Python 3.8+
|
||
- 将Python添加到系统PATH
|
||
- 或使用嵌入式Python
|
||
|
||
### 调试信息
|
||
|
||
如果遇到问题，可以：
|
||
|
||
1. **查看控制台日志** - 开发者工具中的Console
|
||
2. **检查错误信息** - 页面会显示详细错误
|
||
3. **重新加载状态** - 点击"刷新"按钮
|
||
|
||
## 📋 最佳实践
|
||
|
||
### 包管理建议
|
||
|
||
1. **最小化依赖** - 只安装必需的包
|
||
2. **定期更新** - 保持包的最新版本
|
||
3. **测试兼容性** - 升级后测试应用功能
|
||
4. **备份环境** - 记录重要的包列表
|
||
|
||
### 环境选择建议
|
||
|
||
#### 选择嵌入式Python，如果：
|
||
- 希望用户无需安装Python
|
||
- 需要确保环境一致性
|
||
- 应用面向普通用户
|
||
|
||
#### 选择系统Python，如果：
|
||
- 用户是开发者
|
||
- 需要使用系统特定的包
|
||
- 希望减少应用体积
|
||
|
||
## 🔄 维护和更新
|
||
|
||
### 定期维护
|
||
|
||
建议定期：
|
||
1. **检查包更新** - 升级重要的包
|
||
2. **清理无用包** - 卸载不再需要的包
|
||
3. **监控环境状态** - 确保Python环境正常
|
||
|
||
### 版本管理
|
||
|
||
- **记录包版本** - 在项目文档中记录关键包版本
|
||
- **测试兼容性** - 升级前在测试环境验证
|
||
- **回滚计划** - 准备回滚到稳定版本的方案
|
||
|
||
## 🎯 高级功能
|
||
|
||
### 环境变量控制
|
||
|
||
可以通过环境变量强制使用特定Python：
|
||
|
||
```bash
|
||
# 强制使用系统Python
|
||
set MIXVIDEO_FORCE_SYSTEM_PYTHON=1
|
||
|
||
# 启动应用
|
||
cargo tauri dev
|
||
```
|
||
|
||
### 自定义包源
|
||
|
||
如果需要使用自定义PyPI源，可以在设置脚本中修改：
|
||
|
||
```python
|
||
# 在 install_dependencies 函数中添加
|
||
subprocess.run([
|
||
str(python_exe), "-m", "pip", "install",
|
||
"-i", "https://pypi.tuna.tsinghua.edu.cn/simple/",
|
||
dep
|
||
], ...)
|
||
```
|
||
|
||
## 📊 监控和统计
|
||
|
||
管理页面提供：
|
||
- **环境状态概览** - 一目了然的状态信息
|
||
- **包数量统计** - 已安装包的总数
|
||
- **实时状态更新** - 操作后自动刷新状态
|
||
|
||
---
|
||
|
||
通过Python环境管理器，你可以轻松管理应用的Python环境，确保所有功能正常运行！
|