编译FFmpeg时提示“ERROR: libx264 not found”，如何解决？

Question

编译 FFmpeg 时出现 `ERROR: libx264 not found`，本质是 configure 脚本未能定位到 x264 的开发库（头文件与 pkg-config `.pc` 文件）。常见原因有三：① 未安装 x264 开发包（如 Ubuntu 需 `sudo apt-get install libx264-dev`，CentOS/RHEL 用 `yum install x264-devel`）；② 手动编译的 x264 未正确安装（需确认执行了 `make install`，且默认路径 `/usr/local` 下存在 `include/x264.h` 和 `lib/pkgconfig/x264.pc`）；③ 环境变量缺失——若 x264 装在非标准路径（如 `/opt/x264`），须导出 `PKG_CONFIG_PATH=/opt/x264/lib/pkgconfig` 并确保 `PATH` 包含其 `bin/`。验证命令：`pkg-config --modversion x264` 应返回版本号。最后重新运行 FFmpeg configure，建议显式添加 `--enable-libx264 --enable-gpl`。注意：禁用 `--disable-shared` 或遗漏 `--enable-pic` 可能导致链接失败，亦需排查。

Answer 1

```html

一、现象层：错误表征与基础诊断

当执行 ./configure --enable-libx264 时，FFmpeg 构建系统抛出 ERROR: libx264 not found。该错误并非指 x264 二进制缺失，而是 configure 脚本在预检阶段调用 pkg-config --exists x264 失败所致——本质是开发元数据不可见。

二、结构层：x264 开发包的三要素依赖模型

FFmpeg configure 依赖以下三个协同组件完成验证：

• 头文件（如 /usr/local/include/x264.h）→ 用于 C 预处理和 ABI 兼容性检查
• pkg-config 描述文件（x264.pc）→ 提供编译/链接标志（Cflags/Libs）
• 共享库或静态库（libx264.so 或 libx264.a）→ 实际链接目标

三、根因层：三大典型失效路径分析

类别	表现特征	验证命令	修复要点
① 包管理器未装开发包	apt list --installed | grep x264 无 libx264-dev	dpkg -L libx264-dev | grep -E "(include|x264\.h|pkgconfig)"	Ubuntu/Debian：sudo apt-get install libx264-dev；RHEL/CentOS：sudo yum install x264-devel（或 dnf）
② 源码编译未安装	ls /usr/local/include/x264.h 报错；find /usr/local -name "x264.pc" 无结果	pkg-config --modversion x264 2>/dev/null || echo "NOT FOUND"	确认执行过 make install；检查 ./configure --prefix=/usr/local 是否与安装路径一致
③ 非标准路径未注入环境	echo $PKG_CONFIG_PATH 为空或不含 x264 路径	pkg-config --variable=pc_path pkg-config 查看搜索路径	导出：export PKG_CONFIG_PATH="/opt/x264/lib/pkgconfig:$PKG_CONFIG_PATH"；必要时追加 export PATH="/opt/x264/bin:$PATH"

四、深度排查：构建时链接语义链完整性校验

即使 pkg-config --modversion x264 成功，仍需验证链接可行性：

# 获取完整链接参数（应含 -lx264 和 -L 路径）
pkg-config --libs x264

# 检查库文件是否可被 ld 找到（避免 RPATH 缺失）
ldconfig -p | grep x264
readelf -d /usr/local/lib/libx264.so | grep 'SONAME\|RUNPATH'

# 若使用 --disable-shared，必须确保 --enable-pic 已启用（x264 configure 时默认开启）

五、工程实践：推荐的健壮构建流程（Mermaid 流程图）

graph TD
  A[确认系统架构与 ABI] --> B[安装或编译 x264]
  B --> C{是否非标准路径？}
  C -->|是| D[导出 PKG_CONFIG_PATH & PATH]
  C -->|否| E[跳过环境变量设置]
  D --> F[验证 pkg-config --modversion x264]
  E --> F
  F --> G[检查 /usr/local/{include,lib/pkgconfig}]
  G --> H[运行 FFmpeg configure]
  H --> I[显式启用：--enable-libx264 --enable-gpl --enable-pic]
  I --> J[规避陷阱：不加 --disable-shared，除非明确需要静态链接]

六、高阶注意事项：交叉编译与容器化场景

在嵌入式或 CI/CD 环境中，还需关注：

• 交叉工具链隔离：x264 必须用相同 --host 编译，且其 .pc 中 libdir 应指向目标平台库路径
• Docker 构建缓存污染：若 base image 含旧版 x264，但未清理 /usr/local/lib/pkgconfig，会导致版本错配
• FFmpeg configure 的隐式依赖：启用 --enable-libx264 自动要求 GPL 授权，故 --enable-gpl 不可省略；否则 configure 将静默禁用

七、验证闭环：从元数据到运行时的全栈断言

最终验证不应止于 configure 成功，而应覆盖：

1. make -j$(nproc) 无 x264 相关 undefined reference
2. ./ffmpeg -h encoder=libx264 显示编码器详细参数
3. ldd ./ffmpeg | grep x264 确认动态链接正常（若非 static）
4. 生成视频后用 ffprobe -v quiet -show_entries stream=codec_name -of csv=p=0 output.mp4 验证实际编码器为 h264

```