56.Android系统源码-jemalloc 实战：高性能内存分配器核心技术
2026/6/4 6:24:38
ROS2实战：FAST_LIO与Livox Mid360建图避坑全攻略
第一次把FAST_LIO从ROS1移植到ROS2时，我盯着满屏的编译错误发了半小时呆。从#include <ros/ros.h>报错开始，到tf库消失的警告，再到ament_cmake的配置陷阱——这些看似简单的移植问题，往往能让新手浪费整整两天时间。本文将分享我在Livox Mid360建图项目中积累的实战经验，帮你跳过那些教科书不会告诉你的深坑。
1. 环境准备：ROS2与依赖项的正确姿势
1.1 基础环境配置
在开始FAST_LIO移植前，确保你的ROS2环境符合以下要求：
- ROS2版本：Humble Hawksbill（Ubuntu 22.04）或Foxy Fitzroy（Ubuntu 20.04）
- Livox驱动：必须使用
livox_ros_driver2而非ROS1版本 - 系统依赖：
sudo apt install libeigen3-dev libpcl-dev ros-$ROS_DISTRO-pcl-conversions
常见踩坑点：
- 误装ROS1的livox_ros_driver（症状：编译时报ROS1头文件错误）
- PCL库版本不匹配（症状：点云处理函数未定义）
- Eigen3路径错误（症状：矩阵运算相关编译失败）
1.2 工作空间结构优化
ROS2的ament构建系统对工作空间布局更敏感。推荐采用以下结构：
fast_lio_ws/ ├── src/ │ ├── fast_lio_ros2/ # 移植后的主包 │ ├── livox_ros_driver2/ # 官方驱动 │ └── livox_sdk/ # 依赖的SDK └── build/ # 自动生成提示：使用
colcon build替代catkin_make时，务必在每个包的CMakeLists.txt首行添加cmake_minimum_required(VERSION 3.16)
2. 头文件与API迁移实战
2.1 ROS1到ROS2的核心变更
FAST_LIO移植中最常遇到的5个头文件错误及解决方案：
| ROS1头文件 | ROS2替代方案 | 修改示例 |
|---|---|---|
#include <ros/ros.h> | #include "rclcpp/rclcpp.hpp" | 需同步修改ROS_INFO为RCLCPP_INFO |
#include <tf/transform_broadcaster.h> | #include "tf2_ros/transform_broadcaster.h" | 广播器初始化方式不同 |
#include <sensor_msgs/PointCloud2.h> | 保持相同但命名空间变化 | 需添加using sensor_msgs::msg::PointCloud2 |
#include <pcl_conversions/pcl_conversions.h> | 保持相同但需链接pcl_conversions | 在CMake中显式find_package |
#include <nav_msgs/Odometry.h> | 保持相同但消息类型变化 | Odometry变为Odometry::SharedPtr |
2.2 TF2迁移详解
ROS2的tf2库使用方式有重大变化。以位姿广播为例：
ROS1版本：
tf::TransformBroadcaster broadcaster; tf::Transform transform; transform.setOrigin(tf::Vector3(odom.pose.pose.position.x, ...)); broadcaster.sendTransform(tf::StampedTransform(transform, ...));ROS2版本：
auto broadcaster = std::make_shared<tf2_ros::TransformBroadcaster>(node); geometry_msgs::msg::TransformStamped transform; transform.transform.translation.x = odom->pose.pose.position.x; // ...其他赋值 broadcaster->sendTransform(transform);关键差异：
- 不再使用tf命名空间下的数据类型
- TransformBroadcaster需通过节点共享指针管理
- 消息类型变为ROS2原生格式
3. CMakeLists.txt深度改造
3.1 构建系统迁移对照表
| catkin (ROS1) | ament (ROS2) | 注意事项 |
|---|---|---|
find_package(catkin REQUIRED) | find_package(ament_cmake REQUIRED) | 必须放在文件开头 |
catkin_package() | ament_export_dependencies() | 需显式声明所有依赖 |
add_dependencies() | ament_target_dependencies() | 目标级依赖管理 |
include_directories() | target_include_directories() | 现代CMake推荐用法 |
3.2 完整示例配置
cmake_minimum_required(VERSION 3.16) project(fast_lio) # 基础依赖 find_package(ament_cmake REQUIRED) find_package(rclcpp REQUIRED) find_package(tf2_ros REQUIRED) # 第三方库 find_package(Eigen3 REQUIRED) find_package(PCL 1.12 REQUIRED) # 节点构建 add_executable(fast_lio_node src/lio_node.cpp) target_include_directories(fast_lio_node PUBLIC ${EIGEN3_INCLUDE_DIRS} ${PCL_INCLUDE_DIRS} ) ament_target_dependencies(fast_lio_node rclcpp tf2_ros sensor_msgs ) install(TARGETS fast_lio_node DESTINATION lib/${PROJECT_NAME} ) ament_package()4. Livox Mid360专属配置技巧
4.1 驱动参数优化
在msg_MID360_launch.py中调整以下关键参数：
Node( package='livox_ros_driver2', executable='livox_ros_driver2_node', parameters=[{ 'xfer_format': 1, # 使用PointCloud2格式 'multi_topic': 0, 'data_src': 0, 'publish_freq': 20.0, # 降低频率可减少CPU占用 'output_type': 0, 'frame_id': 'livox_frame', 'lvx_file_path': '/home/user/points.lvx', }] )4.2 FAST_LIO参数适配
修改config/mid360.yaml中的关键配置：
feature_extract_enable: false # Mid360无需特征提取 point_filter_num: 1 # 采样间隔 max_iteration: 4 # 迭代次数 filter_size_surf: 0.5 # 平面滤波尺寸 filter_size_map: 0.5 # 地图滤波尺寸常见问题排查：
- 点云显示异常：检查
frame_id是否与驱动设置一致 - 建图漂移：调整
imu_topic和time_sync_enable参数 - 编译通过但节点崩溃：确认PCL版本与ROS2匹配（
ldd检查动态库）
5. 实战调试进阶技巧
5.1 高效调试命令集
# 查看TF树 ros2 run tf2_tools view_frames # 点云可视化（需安装RViz2） ros2 run rviz2 rviz2 -d $(ros2 pkg prefix fast_lio)/share/fast_lio/rviz/mapping.rviz # 性能监控 ros2 topic hz /laser_cloud_surf_last5.2 典型错误速查表
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
Could not find a package configuration file... | 依赖未正确声明 | 在CMakeLists.txt中添加find_package |
undefined reference to pcl::... | PCL链接错误 | 检查target_link_libraries是否包含pcl_common等 |
Transform lookup failed | TF坐标帧问题 | 使用tf2_ros::Buffer::canTransform()预检查 |
| 点云数据延迟 | 时间同步问题 | 在launch文件中添加use_sim_time:=true |
移植完成后第一次看到Mid360生成的3D地图时，那种成就感绝对值得这些折腾。记得保存你的第一个点云地图后，用pcl_viewer查看效果——如果发现墙壁是倾斜的，别慌，那通常是IMU初始位姿没校准好的问题，调整extrinsic_parameter中的旋转矩阵即可解决。