PCL 安装与部署
二、安装与部署
安装步骤
- 用包管理器安装开发包（Ubuntu 上是
libpcl-dev），这一步会带上 Eigen、FLANN、VTK 等依赖。 - 如果项目在 ROS2 里，再安装 ROS 侧的桥接包，用来在 ROS 消息与 PCL 类型之间转换。
- 用 CMake 链接 PCL，按需声明组件，避免链接整个库拖慢构建。
- 写一个最小程序：读一个 PCD 文件、打印点数，确认环境正常。
sudo apt install -y libpcl-dev pcl-tools
# ROS2 侧的消息转换与工具
sudo apt install -y ros-$ROS_DISTRO-pcl-conversions ros-$ROS_DISTRO-pcl-ros
pcl_viewer sample.pcd
CMake 配置
cmake_minimum_required(VERSION 3.16)
project(cloud_demo)
set(CMAKE_CXX_STANDARD 17)
find_package(PCL REQUIRED COMPONENTS
common io filters segmentation registration search)
include_directories(${PCL_INCLUDE_DIRS})
link_directories(${PCL_LIBRARY_DIRS})
add_definitions(${PCL_DEFINITIONS})
add_executable(cloud_demo src/cloud_demo.cpp)
target_link_libraries(cloud_demo ${PCL_LIBRARIES})
只声明用到的组件能明显缩短配置时间。PCL 的模板实现在头文件里，编译单元越少越好，包含头文件时尽量精确到具体算法而不是整个模块。
常见报错排查
| 报错 / 现象 | 原因 | 处理 |
|---|---|---|
| 头文件找不到，或者链接到错误版本的库 | 系统里有多套 PCL（例如 ROS 自带的与系统包各一套） | 统一用一套，在 CMake 里显式指定路径，不要混着用 |
| Failed to find match for field 'rgb' | 点类型不匹配，读进来的类型没有该字段 | 换成带该字段的点类型，或在转换前先检查字段列表 |
| 编译时间极长或内存耗尽 | 模板实例化量大 | 限制并行编译数量，减少不必要的头文件，必要时拆分编译单元 |
| 运行时段错误 | KD 树等对象没有设置输入点云就调用 | 检查每个算法对象是否都调用了 setInputCloud |
| 处理结果是空的 | 阈值过严，或点云本身是空的 | 逐级打印点数，定位在哪个环节被滤空了 |
| 点云看起来「翻转」或位置偏移 | 坐标系或变换矩阵用错 | 确认每帧的 frame_id 与变换方向，检查旋转矩阵是否正交 |
| 帧率跟不上 | 每帧重建 KD 树、分辨率过高 | 先降采样再处理，能复用的索引不要每帧重建 |
