如何在Windows完美安装GeneFace++

Windows 完美安装 GeneFace++ 实操指南
一 环境准备与版本匹配

• 操作系统与工具
• 使用 Windows 10/11 64 位，并确保系统已更新。
• 安装 Python 3.8–3.10（建议用 Anaconda 管理环境），并勾选“Add Python to PATH”。
• 安装 Visual Studio Build Tools 2019/2022（勾选“C++ 桌面开发”组件），用于编译 C/C++ 扩展。
• 可选：安装 CMake ≥ 3.20 并加入 PATH；安装 Git 便于拉取代码。
• GPU 与深度学习库（如需加速）
• 更新 NVIDIA 显卡驱动，安装与 PyTorch 版本匹配的 CUDA Toolkit 与 cuDNN。
• 通过官方命令安装匹配版本的 PyTorch + cuDNN（示例：pip 安装带 cu116 的 torch 与 torchvision），避免 CPU/GPU 版本混用导致运行失败。

二 获取源码与创建虚拟环境

• 获取源码
• 使用 Git 克隆仓库（或下载 ZIP 解压）：git clone https://github.com/your-repo/GeneFace++.git（替换为实际仓库地址）。
• 创建并激活虚拟环境
• Venv：python -m venv geneface_env && geneface_envScriptsactivate
• Conda：conda create -n geneface_env python=3.8 && conda activate geneface_env
• 安装 Python 依赖
• 有 requirements.txt 时：pip install -r requirements.txt
• 无则先装核心依赖：pip install numpy opencv-python torch torchvision
• 若提示缺少编译组件，返回安装 VS Build Tools 的 C++ 桌面开发工作负载。

三 编译与安装步骤

• 进入项目根目录并创建构建目录
• mkdir build && cd build
• 生成工程文件（CMake）
• 常规：cmake ..
• 指定 Python 路径（可选）：cmake .. -DPYTHON_EXECUTABLE=pathtopython.exe
• 编译（优先 Release 以获得最佳性能）
• cmake --build . --config Release
• 安装 Python 包（若工程提供）
• pip install .（或 python setup.py install）
• 验证安装
• 在 Python 中尝试导入项目模块，或运行项目自带的测试脚本，确认无 ImportError/编译错误。

四 常见问题与快速排查

• 找不到 Python.h / 无法编译 C/C++ 扩展
• 安装或修复 Visual Studio Build Tools 的 C++ 桌面开发；确保使用 x64 工具链；必要时用 -DPYTHON_EXECUTABLE 指定 Python。
• torch 与 CUDA 不匹配
• 按项目 README 指定的版本重装 PyTorch（如带 cu116 的版本），或升级/降级 CUDA 与 cuDNN 保持一致；用 torch.cuda.is_available() 验证。
• 依赖冲突或版本过旧
• 在干净的虚拟环境中重装依赖；优先使用 requirements.txt 的锁定版本；必要时升级 pip 后重试。
• 运行示例时报 DLL 加载失败
• 确认 CUDA/cuDNN 与显卡驱动版本匹配；将 CUDA 的 bin 与 cuDNN 的 bin 加入 PATH；重启终端/IDE 后再试。

五 训练或推理前的素材准备

• 视频规格建议
• 时长 3–5 分钟；尺寸 512×512（正方形）；背景 纯色、人物 正面肩部以上、面部清晰且占比较大；动作幅度适中；音频尽量 无杂音；文件名使用 英文。
• 目录与命名
• 按项目 README 的目录结构放置数据与配置，避免中文路径与特殊字符。