Windows 10下使用vcpkg编译ffmpeg如何保留可执行文件的调试符号？

核心问题原因 #

你遇到的问题是两个常见配置错误共同导致的：

1. 你使用的x64-windows triplet默认调用MSVC编译器，生成的调试符号是独立的PDB文件，不会嵌入exe，gdb天然无法识别这类符号
2. vcpkg默认的ffmpeg构建规则没有开启调试符号生成，就算生成*_g.exe文件也只是空壳，没有实际符号信息

具体修复步骤 #

步骤1：切换匹配的编译目标（如果需要用gdb调试） #

如果你的调试工具是gdb，必须将安装命令的triplet替换为mingw系列，例如x64-mingw-dynamic（动态链接）或x64-mingw-static（静态链接），只有mingw-gcc生成的嵌入符号才能被gdb读取。

步骤2：注入编译/链接参数开启符号生成 #

运行vcpkg安装命令前，先设置环境变量强制开启调试符号、关闭优化：

• MSYS2 bash环境下执行：

export CFLAGS="$CFLAGS -g -O0"
export CXXFLAGS="$CXXFLAGS -g -O0"
export LDFLAGS="$LDFLAGS -g"

• PowerShell环境下执行：

$env:CFLAGS += " -g -O0"
$env:CXXFLAGS += " -g -O0"
$env:LDFLAGS += " -g"

步骤3：修改ffmpeg构建规则强制保留符号 #

找到vcpkg目录下的ports/ffmpeg/portfile.cmake文件，在configure配置参数列表中添加两行：

--enable-debug=3
--disable-stripping

该配置会强制ffmpeg生成全量调试符号，并且完全跳过符号剥离步骤。

步骤4：执行构建命令 #

修改后的安装命令参考（以动态链接mingw版本为例）：

./vcpkg install ffmpeg[core,avcodec,avdevice,avfilter,avformat,ffmpeg,ffplay,ffprobe,nvcodec,opencl,postproc,sdl2,swscale,nonfree]:x64-mingw-dynamic --recurse

验证符号 #

构建完成后进入vcpkg/buildtrees/ffmpeg/x64-mingw-dbg/目录，执行gdb ffmpeg_g.exe即可正常加载符号，也可以用以下命令验证符号存在：

objdump --syms ffmpeg_g.exe | grep debug

补充说明 #

如果你习惯用Visual Studio调试，可以保留x64-windows triplet，只需要开启pdb生成即可：在上述步骤2的环境变量中添加/Zi编译参数和/DEBUG链接参数，构建完成后调试符号会以单独的pdb文件存在，直接用Visual Studio加载ffmpeg.exe和对应pdb即可调试。

内容的提问来源于stack exchange，提问作者Vaughn T