GFPGAN 是腾讯 ARC 实验室研发的深度学习人脸修复工具，能够将低质量人脸图像恢复至高清状态。本文将系统讲解该工具在 Windows、Linux 和 macOS 上的部署流程，帮助技术用户快速掌握这一强大的图像修复解决方案。
核心环境配置指南
基础依赖要求
GFPGAN 运行需要以下核心组件：
- Python 3.7 及以上版本（推荐 Anaconda 环境）
- PyTorch 1.7.0 及更高版本
- 可选的 NVIDIA GPU 加速支持（推荐使用）
操作系统适配说明
- Windows 系统：Windows 10/11 64 位版本
- Linux 系统：Ubuntu 18.04+ 或 CentOS 7+
- macOS 系统：macOS 10.15+（Catalina 及以上版本）
高效部署流程
项目资源获取
git clone https://github.com/TencentARC/GFPGAN
cd GFPGAN
依赖组件安装
# 核心依赖安装
pip install basicsr facexlib
# 完整依赖配置
pip install -r requirements.txt
# 开发模式部署
python setup.py develop
# 可选背景增强模块
pip install realesrgan
模型文件准备
# 下载预训练模型
wget https://github.com/TencentARC/GFPGAN/releases/download/v1.3.0/GFPGANv1.3.pth -P experiments/pretrained_models
系统专属配置方案
Windows 环境优化
- 安装 Visual Studio Build Tools（包含 C++ 编译环境）
- 配置 CUDA 与 cuDNN（GPU 用户）
- 验证 Python 环境变量配置
Linux 系统适配
# Ubuntu/Debian 系统
sudo apt update && sudo apt install python3-pip python3-dev libgl1-mesa-glx
# CentOS/RHEL 系统
sudo yum install python3-pip python3-devel mesa-libGL
macOS 环境配置
# Homebrew 依赖管理
brew install python libomp
实用操作指南
基础使用命令
# 基础修复命令
python inference_gfpgan.py -i 输入路径 -o 输出路径 -v 1.3 -s 2
