Windows系统GeneFace++安装指南

Windows系统 GeneFace++ 安装指南
一 环境准备

• 操作系统：Windows 10/11 64位（兼容性更好，驱动与工具链支持更完整）。
• Python：Python 3.8–3.11（建议用 Anaconda 管理环境，避免依赖冲突）。
• 构建工具：Visual Studio Build Tools 2019/2022（勾选“C++ 桌面开发”组件，提供 cl.exe 与 Windows SDK）。
• 依赖库：基础包包括 numpy、opencv-python、torch、torchvision；若项目提供 requirements.txt，优先使用其锁定版本。
• 硬件建议：CPU ≥ i5、内存 ≥ 8GB、存储 ≥ 10GB；如需 GPU 加速，准备 NVIDIA RTX 显卡并安装匹配版本的 CUDA/cuDNN 与显卡驱动。
• 权限与网络：安装软件与配置环境变量建议具备管理员权限；准备稳定网络以下载依赖与模型权重。

二 安装步骤

1. 创建并激活虚拟环境

• CMD/PowerShell：

python -m venv geneface_env
geneface_envScriptsactivate

• 或使用 Anaconda：

conda create -n geneface_env python=3.8
conda activate geneface_env

1. 安装 Python 依赖

• 有 requirements.txt：

pip install -r requirements.txt

• 无则先安装核心依赖：

pip install numpy opencv-python torch torchvision

1. 获取源码

• 推荐方式：

git clone https://github.com/your-repo/GeneFace++.git
cd GeneFace++

• 或下载 ZIP 并解压到本地目录。

1. 编译与安装（含 C/C++ 扩展时）

• 在项目根目录构建：

mkdir build && cd build
cmake ..
cmake --build . --config Release

• 安装 Python 包（若提供）：

pip install .

• 若工程使用 CMake 安装目标：

cmake --install .

1. 可选 环境变量

• 将可执行/库目录（如 D:GeneFace++bin）加入系统 PATH，便于全局调用。

1. 测试安装

• 运行项目示例或测试脚本（以实际文档为准）：

python examples/test.py

• 出现预期输出（如“Test Passed”或图像/视频结果）即表明安装成功。

三 GPU 与驱动配置

• 驱动：安装或更新 NVIDIA 显卡驱动 至较新稳定版。
• 版本匹配：选择与已安装 PyTorch 对应的 CUDA Toolkit 与 cuDNN 版本，避免不兼容导致启动失败或性能异常。
• 验证：在激活的虚拟环境中执行：

python -c "import torch; print('CUDA available:', torch.cuda.is_available())"
返回 True 表示 CUDA 可用。
四 常见问题与排查

• 编译失败（找不到 cl.exe 或 Windows SDK）：确认已安装 Visual Studio Build Tools 2019/2022 并勾选“C++ 桌面开发”，或在“x64 Native Tools Command Prompt”中执行构建。
• 缺少编译依赖：安装或升级 setuptools、wheel、Cython 等构建工具后重试。
• 包冲突/版本不兼容：优先使用项目 requirements.txt；必要时新建虚拟环境并严格按版本安装。
• GPU 不可用：核对 PyTorch + CUDA/cuDNN 版本匹配与显卡驱动；确认未在 CPU-only 的 PyTorch 环境中误用 CUDA。
• 路径或权限问题：避免中文与空格路径；以管理员权限运行安装与命令行操作。

五 后续使用与维护

• 参考项目 README/示例 调用 API 或运行 demo，按需集成到应用。
• 定期 git pull 更新代码与依赖；重大变更前备份环境与权重。
• 如遇问题，优先查阅 项目文档/GitHub Issues 获取针对性帮助。