4. 软件栈搭建：FFmpeg + x265/rav1e 的编译优化，以及VMAF/PSNR客观指标评测工具链

好，咱们进入实战环节。这一章说白了，就是搭积木。你得把编码器、滤镜、评测工具全部编译到一起，形成一个可用的工作流。我见过太多人拿着预编译的二进制文件跑测试，结果要么性能差一截，要么功能缺胳膊少腿。自己动手编译，心里才有底。

4.1 为什么非要自己编译？

你可能会问：「我用 apt install 或者 brew install 不香吗？」嗯，省事是省事，但有两个硬伤：

• 功能裁剪：发行版为了通用性，通常会关掉很多实验性功能。比如 x265 的 10-bit/12-bit 支持、rav1e 的特定汇编优化，默认可能没开。
• 性能损失：预编译包用的编译参数是「大众化」的，不会针对你的 CPU 微架构做调优。我曾在一次测试中发现，自己编译的 x265 比系统自带的快了 18%。

4.2 FFmpeg 编译：打好地基

FFmpeg 是整个软件栈的骨架。它负责解封装、色彩空间转换、滤镜处理，最后把原始帧喂给编码器。我个人习惯把它作为第一个编译目标。

4.2.1 依赖准备

先列一下必须的依赖库。别嫌多，缺一个后面就可能报错。

依赖库	作用	最低版本建议
libx264	H.264 编码（作为参考对比）	≥ 0.164
libx265	HEVC/H.265 编码	≥ 3.5
librav1e	AV1 编码	≥ 0.6.0
libvmaf	VMAF 计算库	≥ 2.3.0
libsvtav1	SVT-AV1 编码（可选但推荐）	≥ 1.4.0

4.2.2 编译命令

下面是我常用的编译脚本片段。注意 --enable-libvmaf 这个选项，很多人会漏掉。

./configure \
  --prefix=/usr/local \
  --enable-gpl \
  --enable-version3 \
  --enable-libx264 \
  --enable-libx265 \
  --enable-librav1e \
  --enable-libvmaf \
  --enable-libsvtav1 \
  --enable-nonfree \
  --extra-cflags="-march=native -mtune=native" \
  --extra-ldflags="-static-libstdc++"

make -j$(nproc)
sudo make install

4.3 x265 编译：10-bit 与汇编优化

x265 是当前 8K HDR 编码的主力。它的编译选项直接影响编码质量和速度。我踩过一个坑：默认编译出来的 x265 只支持 8-bit，而 HDR 内容必须用 10-bit 或更高。

4.3.1 10-bit 支持

编译 x265 时，必须显式开启 10-bit 支持。方法有两种：

• 主二进制支持 10-bit：编译时加 -DHIGH_BIT_DEPTH=ON，但这样 8-bit 内容也会走 10-bit 路径，性能略降。
• 多库分离：同时编译 8-bit 和 10-bit 两个库，运行时按需加载。我推荐这种方式。

# 编译 10-bit 库
cmake -G "Unix Makefiles" \
  -DCMAKE_INSTALL_PREFIX=/usr/local \
  -DHIGH_BIT_DEPTH=ON \
  -DENABLE_SHARED=ON \
  -DENABLE_CLI=OFF \
  -DEXTRA_LINK_FLAGS="-static-libstdc++" \
  source

make -j$(nproc)
sudo make install

# 编译 8-bit 库（主库）
cmake -G "Unix Makefiles" \
  -DCMAKE_INSTALL_PREFIX=/usr/local \
  -DHIGH_BIT_DEPTH=OFF \
  -DENABLE_SHARED=ON \
  -DENABLE_CLI=ON \
  -DEXTRA_LINK_FLAGS="-static-libstdc++" \
  source

make -j$(nproc)
sudo make install

4.3.2 汇编优化开关

x265 大量使用汇编来加速运动估计和变换。编译时默认会检测 CPU 支持哪些指令集。但如果你在容器里编译，可能检测不到 AVX-512。我曾经在 Docker 里编译，结果跑在物理机上时性能没跑满，排查了半天才发现是汇编优化没生效。

4.4 rav1e 编译：Rust 工具链的坑

rav1e 是用 Rust 写的 AV1 编码器。编译它需要先装 Rust 工具链。过程本身不复杂，但有几个细节要注意。

4.4.1 安装 Rust 与编译

# 安装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 编译 rav1e（带汇编优化）
cargo build --release --features "asm"

# 安装到系统
sudo cp target/release/rav1e /usr/local/bin/

这里 --features "asm" 是关键。没有这个 flag，rav1e 会退回到纯 Rust 实现，速度慢 3-5 倍。我第一次编译时就忘了加，跑 8K 内容直接卡死。

4.4.2 生成 C 链接库

要让 FFmpeg 调用 rav1e，需要编译出 librav1e.a 或 librav1e.so。

cargo build --release --features "asm,capi"
# 生成的 .a 文件在 target/release/librav1e.a

然后 FFmpeg 配置时加上 --enable-librav1e 就能识别了。

4.5 VMAF/PSNR 评测工具链

编码器搭好了，怎么评价好坏？光靠眼睛看不行，得有客观指标。VMAF 和 PSNR 是目前最常用的两个。

4.5.1 工具链架构

先看一张整体流程图，理清数据流向。

4.5.2 编译 libvmaf

VMAF 是 Netflix 开源的感知质量指标。编译它需要先装一些 Python 依赖，但核心是 C 库。

git clone https://github.com/Netflix/vmaf.git
cd vmaf
meson setup build --buildtype release \
  -Denable_tests=false \
  -Denable_docs=false \
  -Dbuilt_in_models=true
ninja -j$(nproc) -C build
sudo ninja -C build install

注意 -Dbuilt_in_models=true，这个选项会把 VMAF 的预训练模型编译进库文件，省得运行时再加载外部模型文件。我在离线环境部署时吃过这个亏，模型文件没带全，VMAF 直接报错。

4.5.3 使用 FFmpeg 计算 VMAF

编译好之后，用 FFmpeg 的 libvmaf 滤镜就能算指标了。

ffmpeg \
  -i distorted.mp4 \
  -i source.y4m \
  -filter_complex "[0:v][1:v]libvmaf=model_path=/usr/local/share/model/vmaf_v0.6.1.json:log_path=vmaf_log.json:log_fmt=json" \
  -f null -

4.5.4 PSNR 计算

PSNR 虽然老，但在低码率场景下仍然有参考价值。FFmpeg 内置了 PSNR 滤镜：

ffmpeg \
  -i distorted.mp4 \
  -i source.y4m \
  -filter_complex "[0:v][1:v]psnr=stats_file=psnr_stats.log" \
  -f null -

输出日志里会包含每帧的 Y/U/V 分量 PSNR，以及平均值。我一般会写个脚本把平均值提取出来，方便横向对比。

4.6 避坑指南：编译常见问题

最后，把我这些年踩过的坑集中说一下。

• 链接错误：undefined reference to `vmaf_*' —— 多半是 libvmaf 没装到标准路径，或者 FFmpeg 配置时没找到。检查 pkg-config --libs libvmaf 是否有输出。
• x265 编译报错：unknown instruction set —— 汇编优化检测失败。手动指定 -DCPU_POWER=8 或 -DENABLE_ASSEMBLY=OFF 降级。
• rav1e 编译极慢 —— Rust 编译本来就慢，加上 --features "asm" 后更慢。第一次编译可能需要 20-30 分钟。建议用 --jobs 4 限制并行任务，避免内存爆掉。
• VMAF 结果全是 0 —— 模型路径不对。确认 model_path 指向的 JSON 文件存在且可读。