GeneFace++于Windows的安装流程

Windows 安装流程
一 环境准备

• 操作系统：建议使用 Windows 10/11 64位，并确保系统已更新。
• Python：安装 Python 3.8–3.11（推荐 3.10），可用 Anaconda 或官方安装包；安装时勾选 Add Python to PATH。
• 构建工具：安装 Visual Studio Build Tools 2019/2022（勾选 C++ 桌面开发 工作负载），并准备 CMake ≥ 3.20（加入系统 PATH）。
• GPU 环境（可选但强烈推荐）：
• 更新 NVIDIA 显卡驱动；
• 安装与 PyTorch 版本匹配的 CUDA Toolkit 与 cuDNN；
• 在 PyTorch 官网选择对应命令安装 GPU 版 torch（如 pip 安装带 cu118/cu121 的版本）。
• 基础依赖：后续通过 pip 安装 numpy、opencv-python、torch、torchvision 等（以项目 requirements.txt 为准）。

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

• 获取源码：
• 使用 Git：git clone https://github.com/your-repo/GeneFace++.git（替换为实际仓库地址）
• 或下载 ZIP 并解压到本地目录。
• 创建并激活虚拟环境（任选其一）：
• venv：python -m venv geneface_env → geneface_env\Scripts\activate
• conda：conda create -n geneface_env python=3.10 → conda activate geneface_env
• 升级 pip：python -m pip install -U pip。

三 安装 Python 依赖

• 一键安装（推荐）：在项目根目录执行
• pip install -r requirements.txt
• 手动安装核心依赖（如无 requirements.txt）：
• pip install numpy opencv-python torch torchvision
• GPU 版 PyTorch 安装要点：
• 前往 PyTorch 官网选择对应命令（例如：pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118），确保与已安装的 CUDA 版本一致。
• 若安装过程报 C/C++ 编译相关错误，返回安装或修复 Visual Studio Build Tools 的 C++ 组件。

四 编译与安装（含 C++ 扩展时）

• 在项目根目录执行：
• mkdir build && cd build
• cmake ..（如有多版本 VS，可用 -G "Visual Studio 17 2022" -A x64 指定生成器与平台）
• cmake --build . --config Release（推荐 Release 以获得更佳性能）
• 若项目提供 Python 安装入口：
• pip install .（或 python setup.py install）
• 如需全局调用可执行文件或脚本，可将相应目录加入 PATH。

五 验证与常见问题

• 验证安装：
• 运行项目自带的 示例/测试脚本，确认无 ImportError 或 DLL 加载错误；
• 若包含推理/训练脚本，先以 CPU 模式跑通最小样例，再切换到 GPU 模式验证 CUDA 可用。
• 常见问题与处理：
• “Microsoft Visual C++ 14.0 is required”：安装或修复 Visual Studio Build Tools 的 C++ 组件；
• torch 与 CUDA 不匹配：重装与 CUDA 版本一致的 PyTorch GPU 版本；
• 找不到 CUDA/cuDNN：检查 CUDA_PATH、PATH 是否包含 bin 与 cuDNN bin 目录；
• 依赖冲突：在干净的虚拟环境中重装依赖，或按 requirements.txt 固定版本；
• 权限/路径问题：以 管理员 身份运行命令行，避免中文或空格路径。