MIT Cheetah-Software编译手记：搞定Qt5.10.0路径、LCM依赖与那些诡异的C++报错

MIT Cheetah-Software编译实战：Qt路径配置、LCM依赖与C++报错深度解析

1. 环境准备与依赖管理

在Ubuntu 20.04环境下编译MIT Cheetah-Software，首先需要确保系统基础环境配置正确。不同于普通开源项目，这个四足机器狗的控制系统对Qt版本、LCM消息中间件和Eigen库有着严格的要求。

关键依赖版本要求：

Qt == 5.10.0 LCM >= 1.4.0 Eigen >= 3.3.7

注意：Qt 5.10.0是项目明确要求的版本，其他版本可能导致界面兼容性问题。建议在全新环境中安装，避免与其他Qt项目产生冲突。

安装基础开发工具链：

sudo apt update && sudo apt upgrade -y sudo apt install -y build-essential cmake git libglib2.0-dev \ mesa-common-dev freeglut3-dev coinor-libipopt-dev \ libblas-dev liblapack-dev gfortran

2. Qt 5.10.0定制化安装

Qt作为图形界面框架，其路径配置是编译过程中的第一个拦路虎。官方提供的find_qt_path.sh脚本常因路径不匹配导致编译失败。

正确安装步骤：

1. 下载Qt 5.10.0离线安装包（约2.3GB）
2. 赋予执行权限：

   chmod +x qt-opensource-linux-x64-5.10.0.run

3. 执行安装并仅勾选以下组件：
   • Qt 5.10.0 → Desktop gcc 64-bit
   • Qt Charts
   • Qt Data Visualization

安装完成后，需要修改项目中的路径查找脚本：

# 修改Cheetah-Software/scripts/find_qt_path.sh sed -i 's/Qt5/Qt5.10.0/g' scripts/find_qt_path.sh

常见问题解决方案：

3. LCM消息中间件网络问题攻坚

LCM（Lightweight Communications and Marshalling）是项目实时通信的核心组件，其安装过程常因网络问题受阻。

稳定安装方案：

1. 使用Git镜像源加速克隆：

   git clone https://gitee.com/mirrors/lcm.git

2. 手动编译安装：

   cd lcm && mkdir build && cd build cmake -DCMAKE_BUILD_TYPE=Release .. make -j$(nproc) sudo make install

3. 验证安装：

   lcm-gen --version

提示：如果遇到Python绑定问题，需确保安装了python3-dev：

sudo apt install python3-dev

4. C++编译报错深度解析

项目采用严格的编译选项，将警告视为错误(-Werror)，这导致许多开发者卡在最后一步。以下是典型报错及解决方案：

4.1 stringop-truncation错误

error: ‘char* __builtin_strncpy()’ specified bound equals destination size [-Werror=stringop-truncation]

解决方案： 修改项目根目录CMakeLists.txt：

# 将 set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -Werror") # 改为 set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra")

4.2 内存不足引发的编译中断

fatal error: Killed signal terminated program cc1plus

临时交换分区创建：

sudo fallocate -l 8G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile

4.3 缺失stropts.h头文件

fatal error: stropts.h: No such file or directory

变通解决方案：

sudo touch /usr/include/stropts.h echo "#include <sys/ioctl.h>" | sudo tee -a /usr/include/stropts.h

5. 编译优化与调试技巧

经过上述步骤后，推荐采用以下编译策略：

1. 首次编译使用单线程：

   make -j1

2. 成功后改用多线程加速：

   make -j$(nproc)

3. 针对性重新编译：

   touch src/common/CMakeLists.txt && make

性能优化参数：

# 在CMakeLists.txt中添加 set(CMAKE_CXX_FLAGS_RELEASE "-O3 -march=native") set(CMAKE_C_FLAGS_RELEASE "-O3 -march=native")

6. 仿真环境验证

成功编译后，通过以下命令启动仿真：

./sim/sim & ./user/MIT_Controller/mit_ctrl m s

常见仿真问题排查：

在VMware环境中，建议分配至少4核CPU和8GB内存以获得流畅的仿真体验。如果遇到图形渲染问题，可以尝试改用VirtualBox或物理机安装Ubuntu。