Windows下GeneFace++如何配置

下面给你一份在 Windows 下配置 GeneFace++ 的实用指南，包含环境、依赖、常见坑点和替代方案，尽量贴近真实可跑流程。

一、GeneFace++ 基本情况

GeneFace++ 是音频驱动的说话人脸生成项目（基于 NeRF / 3D 表征），官方仓库：

• https://github.com/liangchen666/GeneFacePlusPlus

⚠️ 注意：

• 官方主要支持 Linux（Ubuntu）
• Windows 不是官方支持平台，但可以跑，主要靠 WSL 或手动适配

二、推荐方案（最稳）

✅ 方案 1：Windows + WSL2（强烈推荐）

这是最接近官方环境、成功率最高的方式。

1. 安装 WSL2

wsl --install

安装 Ubuntu 20.04 / 22.04

2. 安装 CUDA（Windows 主机）

• 安装 NVIDIA 驱动（Windows）
• WSL2 自动共享 GPU（需较新驱动）

3. WSL 内安装环境

sudo apt update
sudo apt install -y python3.9 python3.9-venv git

4. 创建虚拟环境

python3.9 -m venv geneface
source geneface/bin/activate

5. 安装 PyTorch（CUDA 11.8 示例）

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

6. 克隆项目

git clone https://github.com/liangchen666/GeneFacePlusPlus
cd GeneFacePlusPlus
pip install -r requirements.txt

三、方案 2：纯 Windows（不推荐但可行）

1. Python 版本

• ✅ Python 3.9（不要 3.10+）
• ❌ Python 3.11 不兼容很多依赖

2. 安装依赖（重点）

conda create -n geneface python=3.9
conda activate geneface

安装 PyTorch：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

安装项目依赖：

pip install -r requirements.txt

3. 常见 Windows 专属问题

❗ 问题 1：pytorch3d 装不上

解决：

pip install pytorch3d -f https://dl.fbaipublicfiles.com/pytorch3d/packaging/wheels/py39_cu118_pyt2.0.0/wheel.html

❗ 问题 2：opencv / ffmpeg 报错

conda install -c conda-forge ffmpeg
pip install opencv-python-headless

❗ 问题 3：路径问题（Windows 反斜杠）

• 所有路径用 / 或 os.path
• 不要写死 C:\xxx

四、数据准备（关键）

GeneFace++ 需要：

1. 音频（wav）
2. 视频（人脸）
3. 预处理后的 landmarks / coefficients

预处理步骤（Linux / WSL）

python preprocess.py \
--video_path demo.mp4 \
--audio_path demo.wav

⚠️ Windows 直接跑预处理经常失败

五、推理示例

python inference.py \
--audio_path test.wav \
--model_path checkpoints/geneface++.pth

六、如果你只是想“用”

✅ 不想训练，只想生成视频：

• 用作者提供的 pretrained model
• 直接 inference（WSL 最稳）

✅ 不想折腾环境：

• 用 Colab / AutoDL
• Windows 只负责看结果

七、总结建议

如果你愿意，我可以：

• 给你一份 “Windows 一键配置脚本”
• 或 针对你的显卡（如 3060 / 4090）给具体版本
• 或 帮你排查某个报错

你现在是训练还是推理？显卡是什么？