Windows下GeneFace++安装步骤

Windows下GeneFace++安装步骤
一 环境准备

• 操作系统：Windows 10/11 64位（兼容性更好）。
• Python：Python 3.8–3.11（建议用 Anaconda 管理环境，避免依赖冲突）。
• 构建工具：Visual Studio Build Tools 2019/2022（勾选“C++ 桌面开发”组件），以及 CMake ≥ 3.20（加入系统 PATH）。
• GPU 环境（可选但推荐）：NVIDIA 显卡驱动、CUDA Toolkit 与 cuDNN，版本需与后续安装的 PyTorch 匹配。
• 基础依赖：numpy、opencv-python、torch、torchvision（如项目提供 requirements.txt，以该文件为准）。

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

• 克隆或下载源码（请替换为实际仓库地址）：

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

• 创建并激活虚拟环境（二选一）：
• venv：

python -m venv geneface_env
geneface_envScriptsactivate

• conda：

conda create -n geneface_env python=3.8
conda activate geneface_env

• 安装 Python 依赖：

pip install -r requirements.txt
如无 requirements.txt，可先安装核心包：
pip install numpy opencv-python torch torchvision。
三 编译与安装

• 在项目根目录构建：

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

• 若工程包含 Python 扩展或提供安装脚本：

pip install .

• 如需从任意路径运行可执行文件，可将相应目录加入系统 PATH。

四 GPU环境配置要点

• 安装与 PyTorch 版本匹配的 CUDA/cuDNN（两者版本需相互兼容，且与驱动匹配）。
• 安装对应 CUDA 版本的 PyTorch 与 torchvision（如官方提供 GPU 版本命令/whl，优先使用）。
• 验证：

python -c "import torch; print('CUDA available:', torch.cuda.is_available())"。
五 常见问题与快速排查

• 构建失败提示缺少编译工具：安装或修复 Visual Studio Build Tools 的“C++ 桌面开发”组件，确保 CMake 在 PATH 中。
• 下载慢或超时：更换 pip 镜像源（如 -i https://pypi.tuna.tsinghua.edu.cn/simple）。
• 运行示例报错缺少模块：在激活的虚拟环境中执行 pip install -r requirements.txt，或单独 pip install 缺失包。
• 路径或 DLL 找不到：确认已将相关 bin 目录加入 PATH，并使用 Release 构建以获得更稳定的二进制文件。