当我试图搞清楚 FFmpeg 的硬件加速时，我写了一个能自动检测所有 GPU 编码器的小工具

转载于 2025-12-29 12:30:02 发布 · 2 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://01130.hk/zh/currency.html

文章标签：

#it

在过去的几年里，本人陆陆续续接触了不少视频处理相关的项目。每当涉及到FFmpeg的硬件加速部分，本人都会陷入一种“信息过载”的状态：文档很多、接口很多、驱动差异巨大，甚至同一台机器在不同系统下的表现都不一样。

如果您也曾经尝试过让FFmpeg调用GPU编码/解码器，大概率会遇到类似的情况：

明明显卡支持 H.265，却始终无法正常编码
NVEnc、QSV、AMF、VAAPI……到底哪个能用？
为什么 1080p 可以，4K 却失败
Windows 和 Linux 的硬件加速接口完全不是一套逻辑
FFmpeg 的“支持列表”并不能代表你的设备真的支持

这些问题看似简单，但真正排查起来非常耗时间啊啊啊。于是本人干脆写了一个工具，让它自动帮我把所有硬件编码器和解码器都测一遍。

这个工具就是： HwCodecDetect

GitHub 地址： https://github.com/whyb/HwCodecDetect

FFmpeg 的硬件加速生态：复杂，但真实

如果只用 CPU 编码，FFmpeg 的体验非常统一；但一旦涉及 GPU，情况就完全不同了。

多厂商、多接口、多历史包袱

不同厂商有不同的硬件加速接口：

NVIDIA：NVEnc / NVDec
Intel：QSV
AMD：AMF
Apple：VideoToolbox
Linux：VAAPI / Vulkan
Windows：Media Foundation / DXVA2 / D3D11VA / D3D12VA

这些接口之间没有统一标准，甚至同一厂商在不同系统上的表现也不一致。

“支持”不等于“可用”

FFmpeg 文档里写着“支持某某编码器”，但实际情况可能是：

驱动版本不够
显卡架构不支持某个分辨率
系统缺少依赖
FFmpeg 编译参数不完整
某些接口只支持解码，不支持编码

你不测试，根本不知道你的机器到底能不能用。

HwCodecDetect：把所有硬件编码器都跑一遍，结果一目了然

这个工具的核心目标非常直接：

自动检测当前系统上所有可用的硬件编码器/解码器，并测试它们能处理的最大分辨率。

它的工作方式是：

自动生成不同分辨率的测试视频（从 240p 到 8K）
使用 FFmpeg 调用各种硬件编码器
记录成功与失败
输出一份清晰的检测报告

支持的编码器包括：

NVEnc / NVDec
QSV
AMF
VAAPI
Vulkan
Media Foundation
DXVA2 / D3D11VA / D3D12VA
Apple VideoToolbox

基本覆盖了目前所有主流 GPU 加速接口。

为什么我需要这样一个工具？

本人写这个工具的原因其实很简单：

1. 本人不想再猜显卡到底能不能用

不同显卡、不同驱动、不同系统，组合起来就是一堆未知数。

2. 本人不想再查文档

文档写得再详细，也不如直接跑一遍来得准确。

3. 本人不想再被驱动坑

驱动更新后编码能力变化是常见情况，自动检测能避免踩坑。

4. 本人希望它能成为“视频处理工程师的体检工具”

跑一次，你就知道你的机器到底能干什么。

如何使用（非常简单）

方式一：pip 安装（推荐）

pip install hwcodecdetect
hwcodecdetect

方式二：下载可执行文件（无需 Python）

Releases 页面： https://github.com/whyb/HwCodecDetect/releases

下载对应系统的可执行文件即可运行。

方式三：从源码安装

git clone https://github.com/whyb/HwCodecDetect.git
cd HwCodecDetect
pip install .
hwcodecdetect

检测结果长什么样？

工具会输出一份类似“硬件能力体检报告”的结果，包含：

哪些编码器可用
哪些解码器可用
每个编码器支持的分辨率
哪些接口失败了
哪些格式被显卡硬件支持

对于需要做视频转码、媒体服务器、AI 视频处理、云渲染的开发者来说，这份报告非常有价值。

效果演示：

hwcodecdetect

这个项目适合哪些人？

如果您正在做：

视频转码服务
FFmpeg 自动化脚本
媒体服务器（Jellyfin / Emby / Plex）
GPU 加速推理前处理
视频编码性能测试
多平台视频工具开发

那么这个工具能帮你节省大量时间。

最后

如果你觉得这个工具对你有帮助，欢迎来 GitHub 点个 Star 啊啊啊，也欢迎分享给您的同事或朋友。

https://github.com/whyb/HwCodecDetect

如果您在使用过程中遇到任何问题，也欢迎在 issue 里交流，我会持续维护和改进。