mxivideo/docs/MANUAL_PYTHON_SETUP.md

手动Python环境设置指南

🎯 概述

如果自动设置嵌入式Python失败，可以按照这个指南手动设置。

🔧 方法1：手动运行设置脚本

1. 检查脚本是否存在

# 检查Python设置脚本
dir scripts\setup_embedded_python.py
dir scripts\setup_embedded_python.bat

2. 手动运行Python脚本

# 切换到项目根目录
cd /d "你的项目路径"

# 运行Python设置脚本
python scripts\setup_embedded_python.py

3. 手动运行批处理脚本

# 运行批处理脚本
scripts\setup_embedded_python.bat

🔧 方法2：完全手动设置

如果脚本无法运行，可以完全手动设置：

1. 下载Python嵌入式版本

1. 访问 Python官网
2. 下载 python-3.11.0-embed-amd64.zip
3. 解压到 src-tauri/python-embed/ 目录

2. 设置pip

# 进入Python嵌入式目录
cd src-tauri\python-embed

# 下载get-pip.py
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

# 修改python311._pth文件
# 将 #import site 改为 import site

# 安装pip
python.exe get-pip.py

3. 安装依赖包

# 在python-embed目录中
python.exe -m pip install requests
python.exe -m pip install Pillow
python.exe -m pip install certifi

4. 复制python_core模块

# 从项目根目录
xcopy python_core src-tauri\python-embed\python_core /E /I

5. 测试安装

# 测试Python
src-tauri\python-embed\python.exe --version

# 测试依赖
src-tauri\python-embed\python.exe -c "import requests, PIL; print('OK')"

# 测试python_core
src-tauri\python-embed\python.exe -c "import python_core; print('python_core OK')"

🔧 方法3：使用系统Python

如果嵌入式Python设置困难，可以使用系统Python：

1. 安装系统Python

1. 下载并安装 Python 3.8+
2. 确保添加到PATH

2. 安装依赖

pip install requests Pillow certifi

3. 设置环境变量

# 强制使用系统Python
set MIXVIDEO_FORCE_SYSTEM_PYTHON=1

4. 启动应用

cargo tauri dev

🧪 验证设置

1. 检查Python环境管理页面

1. 启动应用：cargo tauri dev
2. 访问 /python-env-manager
3. 查看环境状态：
   • 绿色：设置成功
   • 红色：需要进一步设置

2. 测试基本功能

在Python环境管理页面中：

1. 点击"刷新"按钮
2. 尝试安装一个测试包（如 requests）
3. 查看已安装包列表

3. 测试Python Core功能

1. 访问 /python-core-test
2. 运行基础功能测试
3. 检查是否显示"Using embedded Python"或"Using system Python"

🔍 故障排除

问题1：Python命令不存在

解决方案：

• 安装Python并添加到PATH
• 或使用完整路径：C:\Python311\python.exe

问题2：权限问题

解决方案：

• 以管理员权限运行命令提示符
• 或选择用户目录进行安装

问题3：网络问题

解决方案：

• 检查防火墙设置
• 使用国内镜像：

  python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ requests
  

问题4：模块导入失败

解决方案：

• 检查PYTHONPATH设置
• 确保python_core目录结构正确
• 验证__init__.py文件存在

📋 目录结构检查

设置完成后，目录结构应该如下：

your-project/
├── src-tauri/
│   ├── python-embed/          # 嵌入式Python（如果使用）
│   │   ├── python.exe
│   │   ├── python311.dll
│   │   ├── Lib/
│   │   ├── Scripts/
│   │   └── python_core/       # 你的Python模块
│   └── tauri.conf.json
├── python_core/               # 原始Python代码
└── scripts/
    ├── setup_embedded_python.py
    └── setup_embedded_python.bat

🎯 推荐方案

根据你的情况选择：

对于开发者

• 使用系统Python（方法3）
• 更容易调试和开发

对于最终用户

• 使用嵌入式Python（方法1或2）
• 用户无需安装Python

对于企业部署

• 使用嵌入式Python
• 确保环境一致性

📞 获取帮助

如果仍然遇到问题：

1. 检查日志：查看控制台输出
2. 验证环境：确认Python版本和依赖
3. 简化测试：先测试最基本的功能
4. 查看文档：参考相关技术文档

---

通过这些方法，你应该能够成功设置Python环境。选择最适合你情况的方法即可。