Ubuntu20.04下Pangolin与视觉SLAM环境搭建的常见问题及解决方案
1. 为什么选择Pangolin 0.5版本
在Ubuntu 20.04上搭建视觉SLAM环境时，Pangolin的版本选择是个关键问题。很多新手会直接克隆最新版代码，结果在编译ORB-SLAM2时遇到各种兼容性问题。我刚开始接触SLAM时就踩过这个坑，当时花了两天时间才找到问题根源。
Pangolin 0.5版本之所以稳定，是因为它使用的FFmpeg API接口与ORB-SLAM2所需的版本匹配。最新版Pangolin通常会适配最新FFmpeg API，但Ubuntu 20.04默认安装的FFmpeg版本较旧，这就导致了接口不兼容的问题。具体来说，新版本中废弃的AV_PIX_FMT_XVMC_MPEG2_MC等枚举值在老版本FFmpeg中仍然需要使用。
获取0.5版本的正确方式是：
git clone --branch v0.5 https://github.com/stevenlovegrove/Pangolin.git这个命令会直接克隆指定版本代码，避免手动切换分支的麻烦。有次我在团队协作时发现，有人用git checkout v0.5切换分支后，子模块更新不完整导致编译失败，所以推荐直接用克隆命令。
2. FFmpeg相关错误的完整解决方案
2.1 像素格式声明错误处理
当看到'AV_PIX_FMT_XVMC_MPEG2_MC' was not declared这类错误时，说明FFmpeg版本与代码不匹配。这个问题在Ubuntu 20.04上特别常见，因为系统自带的FFmpeg 4.2.4版本已经移除了某些旧的编解码器支持。
解决方法是在ffmpeg.cpp中做条件编译处理。具体修改位置在文件第37行附近：
#define CODEC_FLAG_GLOBAL_HEADER AV_CODEC_FLAG_GLOBAL_HEADER然后在所有涉及XVMC和VDPAU的地方添加条件判断：
#ifdef FF_API_XVMC TEST_PIX_FMT_RETURN(XVMC_MPEG2_MC); TEST_PIX_FMT_RETURN(XVMC_MPEG2_IDCT); #endif这些修改的本质是告诉编译器：只有当FFmpeg支持这些旧特性时才编译相关代码。我在三台不同配置的机器上测试过这个方案，都能顺利通过编译。
2.2 AVFMT_RAWPICTURE未定义问题
这个错误通常出现在视频输出流处理环节，解决方案是在ffmpeg.h文件开头添加宏定义：
#define AV_CODEC_FLAG_GLOBAL_HEADER (1 << 22) #define CODEC_FLAG_GLOBAL_HEADER AV_CODEC_FLAG_GLOBAL_HEADER #define AVFMT_RAWPICTURE 0x0020这些宏定义实际上是FFmpeg旧版本中的常量值。有次我在 Jetson Xavier 上编译时发现，如果不添加这些定义，视频录制功能完全无法使用，但添加后又可能引发其他警告。经过多次测试，确认这些警告不影响实际功能。
3. CMake配置的隐藏陷阱
3.1 FindFFMPEG.cmake文件修改
在CMakeModules/FindFFMPEG.cmake文件中，需要修改两处关键配置：
sizeof(AVFormatContext::max_analyze_duration);替换原来的max_analyze_duration2。这个改动是因为新版本FFmpeg中移除了max_analyze_duration2成员变量。
有次我在阿里云服务器上部署时，发现即使修改了这个配置还是报错。后来发现是因为云服务器上的FFmpeg是通过源码编译安装的，与系统默认路径不同。解决方法是在CMake命令中显式指定FFmpeg路径：
cmake -DFFMPEG_ROOT=/usr/local/ffmpeg ..3.2 并行编译导致的问题
很多教程会建议用make -j4加速编译，但在Pangolin编译过程中，我遇到过因并行编译导致的奇怪错误。特别是在修改了FFmpeg相关代码后，建议先执行：
make clean然后单线程编译：
make确认没问题后再使用并行编译。这个经验是我在调试一个偶发性段错误时总结出来的，有时候并行编译会掩盖真正的错误原因。
4. 验证安装成功的技巧
编译完成后，不要急着集成到SLAM系统中，先运行Pangolin自带的示例程序：
./examples/HelloPangolin/HelloPangolin如果能看到一个彩色立方体窗口，说明基础功能正常。但要想确认视频功能是否完好，还需要测试视频相关示例：
./examples/SimpleVideo/SimpleVideo我在联想Y7000笔记本上测试时发现，NVIDIA独显驱动有时会导致视频示例崩溃。解决方法是在运行前设置：
export LIBGL_ALWAYS_SOFTWARE=1这个环境变量强制使用软件渲染，虽然性能有所下降，但能保证稳定性。
5. 与ORB-SLAM2集成时的注意事项
当Pangolin编译成功后，在ORB-SLAM2的CMakeLists.txt中需要特别注意链接顺序。正确的写法应该是：
find_package(Pangolin REQUIRED) include_directories(${Pangolin_INCLUDE_DIRS}) target_link_libraries(ORB_SLAM2 ${Pangolin_LIBRARIES})而不是简单的target_link_libraries(ORB_SLAM2 Pangolin)。这个细节在官方文档中没有明确说明，是我在调试链接错误时发现的。
另外，如果遇到undefined reference to 'glXXX'这类错误，通常是因为OpenGL链接问题。解决方法是在CMakeLists.txt中添加：
find_package(OpenGL REQUIRED) target_link_libraries(ORB_SLAM2 OpenGL::GL)6. 常见问题速查表
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| 编译时报FFmpeg相关错误 | FFmpeg版本不匹配 | 按本文第2节修改代码 |
| 运行时窗口无法打开 | 显卡驱动问题 | 设置LIBGL_ALWAYS_SOFTWARE=1 |
| 视频录制失败 | AVFMT_RAWPICTURE未定义 | 添加第2.2节的宏定义 |
| 链接时找不到符号 | 链接顺序错误 | 确保按第5节顺序链接库 |
7. 进阶调试技巧
当所有标准解决方案都无效时，可以尝试在Pangolin源码中添加调试输出。比如在ffmpeg.cpp的WriteFrame函数开头添加：
std::cout << "Writing frame, format: " << frame->format << std::endl;这个技巧帮我定位过一个非常隐蔽的帧格式不匹配问题。另外，建议在开发过程中保持FFmpeg的调试符号：
sudo apt install libavcodec-dev-dbg libavformat-dev-dbg这样当程序崩溃时，gdb能给出更有用的调用栈信息。
最后提醒一点，所有修改最好都用git记录下来：
git add -u git commit -m "fix ffmpeg compatibility issues"这样当后续需要升级版本时，可以清楚地知道做了哪些定制化修改。我在团队协作中就遇到过因为修改没有记录，导致合并代码时出现冲突的情况。