Windows部署GeneFace++的步骤

Windows 部署 GeneFace++ 步骤
一 环境准备

• 操作系统与权限：建议使用 Windows 10/11 64 位，以管理员权限安装软件与环境变量。硬件建议 CPU ≥ 2 核 2GHz、内存 ≥ 8GB、存储 ≥ 10GB，如需 GPU 加速需 NVIDIA 显卡并准备最新驱动。
• Python 与虚拟环境：安装 Python 3.8/3.9（3.6+ 亦可），推荐使用 Anaconda/venv 隔离环境。
• 编译工具：安装 Visual Studio Build Tools 2019/2022，勾选 C++ 桌面开发 组件；确保 CMake 已加入系统 PATH。
• 多媒体工具：安装 ffmpeg（含 ffplay、ffprobe），用于音视频编解码与处理。
• GPU 驱动与 CUDA（可选）：如需 GPU，先更新 NVIDIA 驱动；后续按项目要求安装与 PyTorch 版本匹配的 CUDA/cuDNN。

二 获取源码与安装依赖

• 获取源码：从官方 GitHub 仓库克隆或下载源码压缩包，进入项目根目录。
• 创建并激活虚拟环境：
• venv：python -m venv geneface_env && geneface_env\Scripts\activate
• conda：conda create -n geneface_env python=3.8 -y && conda activate geneface_env
• 安装 Python 依赖：优先使用项目提供的 requirements.txt 一键安装；若未提供，先安装基础包：pip install numpy opencv-python torch torchvision。如使用 GPU，需安装与 CUDA 版本匹配的 torch/torchvision（版本对应关系以项目说明或 PyTorch 官网为准）。

三 编译与安装

• 若项目包含 C/C++ 或 CUDA 扩展，使用 CMake 构建：

1) 在项目根目录创建并进入构建目录：mkdir build && cd build
2) 生成工程文件（示例为 VS2019 x64）：
cmake .. -G "Visual Studio 16 2019" -A x64 -DPYTHON_EXECUTABLE=path\to\python.exe
如使用 VS2022 或默认生成器，可简化为 cmake ..
3) 编译（推荐 Release 模式）：cmake --build . --config Release
4) 若提供 Python 安装入口，执行：pip install .

• 如项目为纯 Python 包，可直接：pip install -e . 或 python setup.py install。

四 运行验证与常见问题

• 运行验证：按项目 README 执行示例脚本或命令，检查日志无报错、模型权重加载成功、音视频输入输出正常。
• 常见问题与处理：
• 缺少 C++ 编译工具：安装/修复 Visual Studio Build Tools 的 C++ 桌面开发 组件。
• 找不到 ffmpeg：将 ffmpeg 的 bin 目录加入 PATH。
• GPU 不可用或版本不匹配：确认 NVIDIA 驱动已更新，安装与 PyTorch 版本匹配的 CUDA/cuDNN，可用 torch.cuda.is_available() 验证。
• 依赖冲突：在干净的虚拟环境中重装依赖，或按项目 requirements.txt 固定版本。
• 构建失败：优先使用 x64 + Release 配置，确保 CMake 与 VS 位数/工具集一致。

五 可选配置

• 全局调用：将项目的可执行文件或脚本目录加入系统 PATH，便于在任意路径运行。
• 环境持久化：在虚拟环境激活脚本或系统环境变量中固化 ffmpeg、CUDA、Python 等路径，减少重复配置。