GeneFace++在Windows怎么装

GeneFace++ 是一个基于 PyTorch 的声音驱动人脸生成（ talking face / lip sync ）项目，官方主要在 Linux 下开发和测试，但在 Windows 上也可以跑，只是坑比较多。下面给你一套尽量能一次装通的 Windows 安装思路。

一、前置环境（必须）

1️⃣ 系统要求

• Windows 10 / 11（64 位）
• 有 NVIDIA 显卡（强烈建议）
• 驱动已更新
• 支持 CUDA（如 3060 / 4070 等）

2️⃣ 安装基础软件

1. Git

• https://git-scm.com/

1. Miniconda（推荐）

• https://docs.conda.io/en/latest/miniconda.html

1. CUDA & cuDNN（可选但建议）

• 一般 PyTorch 自带 CUDA
• 如手动装：CUDA 11.8 最稳

二、克隆 GeneFace++ 代码

git clone https://github.com/GeneFace/GeneFacePlusPlus.git
cd GeneFacePlusPlus

三、创建 Conda 环境（关键）

⚠️ 不要直接用系统 Python

conda create -n genefacepp python=3.9 -y
conda activate genefacepp

四、安装 PyTorch（Windows 重点）

根据你的 CUDA 版本（示例 11.8）：

pip install torch==2.0.1+cu118 torchvision==0.15.2+cu118 --index-url https://download.pytorch.org/whl/cu118

验证：

python -c "import torch; print(torch.cuda.is_available())"

输出 True 才算成功。

五、安装项目依赖

1️⃣ 基础依赖

pip install -r requirements.txt

⚠️ Windows 常见报错的包：

• pywinpty
• ninja
• opencv-python

如失败可单独装：

pip install opencv-python ninja

2️⃣ 编译 / 安装特殊模块

GeneFace++ 有 C++ / CUDA 扩展：

pip install -e .

如果报错：

• 安装 Visual Studio Build Tools
• 勾选：C++ 桌面开发
• 确保 cl 命令可用

六、下载预训练模型（必须）

官方文档：
https://github.com/GeneFace/GeneFacePlusPlus
一般：

bash scripts/download_pretrained.sh

⚠️ Windows 没 bash：

• 用 Git Bash
• 或手动下载并放到对应目录

七、运行示例（测试）

python inference.py \
--poser ckpt/poser_trainer_v1/last.ckpt \
--audio examples/driven_audio/test.wav

八、Windows 常见坑总结

九、如果你只是想“用”而不是“研究”

✅ 更推荐：

• Linux（WSL2）
• 或直接用 Colab / AutoDL

如果你愿意，可以告诉我：

• 显卡型号
• 是否只做人脸动画 / 实时
• 是否准备训练还是只推理

我可以给你更精确的 Windows 安装命令。